Enables distributed processing and resource sharing across the Covia network via grid operations. Provides access to remote venues, distributed job execution, and collaborative computing capabilities. Perfect for scaling computational tasks, leveraging distributed resources, and building resilient, distributed AI applications.
| Name: | grid |
| Class: | covia.adapter.GridAdapter |
This adapter provides 4 MCP tool(s) for AI agent integration:
| Tool Name | Description |
|---|---|
| grid_job_status | Fetch the current status of an EXISTING Covia Job. Call this operation directly with the exact id returned by a delegated request or asynchronous invocation; do not wrap it in the generic operation runner. This polls state without waiting for completion or starting new work. |
| grid_invoke | Submit any operation on the local or a remote venue and return immediately with a job snapshot — does not block. Use grid_run if you want the result inline. The escape hatch for invoking operations not exposed as MCP tools: discover with covia_inspect path=v/ops, drill into a group, then invoke any path. The operation argument accepts every resolvable form: v/ops/json/merge (venue catalog), o/my-pipeline (your pin), a/<hash> (asset by content hash), or did:web:<host>/v/ops/... (remote venue). Returns a job snapshot — poll with grid_job_status or wait for the result with grid_job_result(id=<returned id>). |
| grid_run | Execute a NEW operation and return its result. Use for normal catalog/asset invocation, not to poll or retrieve an existing Job: call the separately advertised Job-status or Job-result operation directly with that Job's id. The operation argument accepts an exact resolvable reference: v/ops/json/merge (venue catalog), o/my-pipeline (your pin), a/<hash> (asset), or did:web:<venue>/a/<hash> (definition fetched from the publishing venue, executed where this op runs). Never construct an operation path by reversing or splitting a provider-facing tool name; use a reference obtained from catalog metadata, config, or the task. To execute ON another venue, pass its URL or DID in the venue argument. Pass input matching the operation's schema. Blocks until complete; use the separately advertised asynchronous invocation operation for long-running work. |
| grid_job_result | Wait for an EXISTING Covia Job to finish and return its output. Call this operation directly with the exact id returned by a delegated request or asynchronous invocation; do not wrap it in the generic operation runner. With no timeout, blocks until the Job completes. With timeout, errors if it has not 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. |