Tool Details: grid_job_status

Basic Information

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

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://venue-3.covia.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "grid_job_status",
    "arguments": {
      "input": "your input here"
    }
  }
}
cURL Example:
curl -X POST https://venue-3.covia.ai/mcp \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "grid_job_status",
      "arguments": {
        "input": "your input here"
      }
    }
  }'
Python Example:
import requests
import json

url = "https://venue-3.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "grid_job_status",
        "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://venue-3.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'grid_job_status',
        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": "grid_job_status",
		"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": {
					"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