MCP Tool: grid_job

Basic Information

Tool Name:	grid_job_result
Asset Name:	Grid Job Result
Description:	Wait for a Covia grid job to finish and return its output. Use after agent_request (or any async invocation) to retrieve the result. With no timeout, blocks until the job completes. With timeout, errors if the job hasn't completed in time — callers wanting a result treat missing-result as failure. Retry (with a longer timeout) or fall back to alternative work if a timeout occurs.
Adapter:	grid
Asset Hash:	`0xa6f4837c558a6fba716dea93c31a8ce8675e5cc76c6bef85819e365564f43493`

Input

Property	Type	Description
`venue`	string	Optional remote venue URL or DID to query
`id`*	string	Job identifier returned from a previous grid invocation
`timeout`	integer	Optional max milliseconds to wait. Omitted or <=0 means no timeout (block until done). On timeout the operation ERRORS — a missing result is a failure.

Output

Type: object

Schema: <code>{ "description": "Output value of the referenced job" }</code>

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_result",
    "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_result",
      "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_result",
        "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_result',
        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 Result",
	"description": "Wait for a Covia grid job to finish and return its output. Use after agent_request (or any async invocation) to retrieve the result. With no timeout, blocks until the job completes. With timeout, errors if the job hasn't completed in time — callers wanting a result treat missing-result as failure. Retry (with a longer timeout) or fall back to alternative work if a timeout occurs.",
	"operation": {
		"adapter": "grid:jobResult",
		"toolName": "grid_job_result",
		"input": {
			"type": "object",
			"properties": {
				"id": {
					"type": "string",
					"description": "Job identifier returned from a previous grid invocation"
				},
				"timeout": {
					"type": "integer",
					"description": "Optional max milliseconds to wait. Omitted or <=0 means no timeout (block until done). On timeout the operation ERRORS — a missing result is a failure."
				},
				"venue": {
					"type": "string",
					"description": "Optional remote venue URL or DID to query"
				}
			},
			"required": ["id"]
		},
		"output": {
			"description": "Output value of the referenced job"
		}
	}
}

Tool Details: grid_job_result