Tool Details: gridJobStatus

Basic Information

Tool Name:gridJobStatus
Asset Name:Grid Job Status
Description:Fetch the current status of a Covia grid job by ID
Adapter:grid
Asset Hash:0xa4d5d729d7e8561de169c32a75420c7b75fdfeb548d27e5c98c6095808214c5c
Input
PropertyTypeDescription
venuestringOptional remote venue URL or DID to query
id*stringJob identifier returned from a previous grid invocation
Output
PropertyTypeDescription
statusstringCurrent job status (e.g. PENDING, STARTED, COMPLETE, FAILED, CANCELLED)
idstringRemote job identifier
createdintegerTimestamp when the job was created (milliseconds since epoch)
updatedintegerTimestamp when the job status was last updated (milliseconds since epoch)
outputanyOperation output, when available
errorstringError message if the job failed

MCP Tool Usage Examples

This tool can be called via the MCP (Model Context Protocol) endpoint. Here are examples of how to use it:

JSON-RPC Call Example:

POST to https://mcp-1st-birthday-agentic-economics.hf.space/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "gridJobStatus",
    "arguments": {
      "input": "your input here"
    }
  }
}
cURL Example:
curl -X POST https://mcp-1st-birthday-agentic-economics.hf.space/mcp \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "gridJobStatus",
      "arguments": {
        "input": "your input here"
      }
    }
  }'
Python Example:
import requests
import json

url = "https://mcp-1st-birthday-agentic-economics.hf.space/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "gridJobStatus",
        "arguments": {
            "input": "your input here"
        }
    }
}

response = requests.post(url, json=payload)
result = response.json()
print(result)
JavaScript/Node.js Example:
const fetch = require('node-fetch');

const url = 'https://mcp-1st-birthday-agentic-economics.hf.space/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'gridJobStatus',
        arguments: {
            input: 'your input here'
        }
    }
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data));

Asset Metadata

{
	"name": "Grid Job Status",
	"description": "Fetch the current status of a Covia grid job by ID",
	"operation": {
		"adapter": "grid:jobStatus",
		"toolName": "gridJobStatus",
		"input": {
			"type": "object",
			"properties": {
				"id": {
					"type": "string",
					"description": "Job identifier returned from a previous grid invocation"
				},
				"venue": {
					"type": "string",
					"description": "Optional remote venue URL or DID to query"
				}
			},
			"required": ["id"]
		},
		"output": {
			"type": "object",
			"description": "Job status information returned by the venue",
			"properties": {
				"id": {
					"type": "string",
					"description": "Remote job identifier"
				},
				"status": {
					"type": "string",
					"description": "Current job status (e.g. PENDING, STARTED, COMPLETE, FAILED, CANCELLED)"
				},
				"created": {
					"type": "integer",
					"description": "Timestamp when the job was created (milliseconds since epoch)",
					"format": "int64"
				},
				"updated": {
					"type": "integer",
					"description": "Timestamp when the job status was last updated (milliseconds since epoch)",
					"format": "int64"
				},
				"output": {
					"type": "any",
					"description": "Operation output, when available"
				},
				"error": {
					"type": "string",
					"description": "Error message if the job failed"
				}
			}
		}
	}
}

Navigation

Back to adapter details

Back to all adapters

Back to index