x402ai-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| X402AI_DRY_RUN | No | Set to 1 for quote-only mode; paid tools return the price quote and never sign. No key needed. | |
| X402AI_MAX_SESSION_USD | No | Total amount the server may spend per process. Defaults to 0.25. An invalid value stops the server at startup. | 0.25 |
| X402AI_BUYER_PRIVATE_KEY | No | Buyer private key in hex. Needed only for paid tools; never logged and scrubbed from error messages. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| embedA | Compute a text embedding vector. Costs $0.01 (USDC on Base) per call. Spends real money; subject to a per-payment and per-session cap. Pass the text in |
| summarizeA | Summarize text. Costs $0.02 (USDC on Base) per call; takes 5-16 s. Spends real money; subject to a per-payment and per-session cap. Pass the text in |
| askA | Ask a question and get an answer. Costs $0.04 (USDC on Base) per call; takes 5-16 s. Spends real money; subject to a per-payment and per-session cap. Pass the question in |
| healthA | Free. Check GET /health on api.x402ai.dev and show local session spend. No key needed. |
| inspectA | Free, never signs or pays. Fetch an https URL unpaid, decode its x402 payment-required header, and check it with Coinbase CDP validate and merchant discovery. Sends the URL to api.cdp.coinbase.com. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: embed computes vectors, summarize condenses text, ask answers questions, health checks service/session spend, and inspect handles unpaid x402 URL diagnostics. Health and inspect are both free diagnostics, but their descriptions make the boundary clear.
The tool names are short lowercase single words with mostly action verbs (embed, summarize, ask, inspect), and only health is a noun. This is a minor deviation from a strict verb pattern but remains highly readable and predictable.
Five tools is well-scoped for a small paid AI API surface: three paid operations plus two diagnostic utilities. Each tool earns its place without an excessive surface.
The surface covers the core paid AI operations and includes health/session-spend and x402 inspection utilities. A minor gap is the absence of a dedicated pricing, balance, or payment-status tool beyond local session spend in health.