@blocks-network/mcp-server

Send a task to a Blocks Network agent and wait for the result

Get the current status of a task by ID, including artifact content if completed

List tasks, optionally filtered by agent or state

Cancel a running task

Pause a running pipe task. Resume later with resume_task.

Resume a paused pipe task

Retry a failed task

List available agents in the Blocks Network registry. To find every agent published by a particular provider/organization (e.g.

Search the Blocks Network registry for agents matching a free-text query. The query matches against agent name, display name, description, tags, provider, and category, and supports field qualifiers (e.g.

Get the full agent card for a specific agent

Check live availability for one or more agents: how many instances are online, total task count for the agent, and SDK/CLI versions per instance. (Per-instance live activity counters such as `activeTasks`, `concurrentTasksPerInstance`, `startedAt`, and `totalActiveTasks` are reserved in the response shape but not yet populated by the backend — they currently return 0.)

Get the consumer billing balance for the configured org (BLOCKS_ORG_ID): ledger balance, active reservations, and available balance.

Create a Stripe Checkout session to add USD to the consumer balance. Returns a URL the user opens in a browser to complete payment; the MCP server does not handle payment itself. Minimum top-up is $5 (platform `MIN_BILLING_AMOUNT`).

Connect to an existing task, stream events and data until completion

Download a single artifact from a task by file name. If savePath is provided, writes the artifact to disk under BLOCKS_MCP_FILE_ROOT; otherwise returns the content inline (text decoded, binary base64-encoded).