MAGENT

MCP hosts

stdio MCP client

Local stdio client for MCP hosts. It pages every paid Magent tool and pays each call with the caller's x402 key. The paid product remains the HTTP API.

HTTP agents pay with x402 V2 exact on Base. HTTP 400 does not charge. HTTP 402 is unpaid. HTTP 503 is settlement uncertainty — retry the same PAYMENT-SIGNATURE.

Install

Node >= 20. 0xYOUR_SPENDING_KEY is a placeholder, never a real key.

{
  "mcpServers": {
    "magent": {
      "command": "npx",
      "args": ["-y", "@magentlab/mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0xYOUR_SPENDING_KEY"
      }
    }
  }
}

Environment

NameRequiredMeaning
X402_PRIVATE_KEYrequired0x + 64 hex. Never logged.
MAGENT_API_URLoptionalOrigin only. Default https://api.magentlab.com.

Tools

The tool name is the public slug. A calculator URL is /api/calc/{slug}. Code tools are /api/codes/search and /api/codes/lookup.

One tool is either one request or POST {items} of 1 to 25 rows. Those rows are a batch on the same tool.

tools/list pages 40 tools. Follow nextCursor. Schemas come from the server, including oneOf. Numeric arguments stay numbers, not strings.

Ping, health, catalog, OpenAPI, llms, HTML, console, and the paywall are not tools.

Calls

An unpaid tools/call returns the HTTP 402 payment required object. HTTP 400 does not charge and does not echo the argument. HTTP 503 retries the same payment.

A successful MCP call does not mark the GET path LIVE.

There is no mcp:// resource URL and no batch-settlement or channel signer.

Not a medical device. Patient names and MRNs are not accepted inputs.

Same x402 handshake: Payments.

Not a medical device. Not a diagnosis or dosing recommendation.