obolpay-x402-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| discover | Return the x402 gateway's machine-readable manifest: price, token, network, recipient, payment flow, free-preview and proof-of-purchase capabilities. No payment required. |
| preview | Fetch the HTTP 402 challenge and return its FREE preview (a sample of the paid dataset) plus the price/invoice, so the agent can decide whether to pay. No payment required. |
| purchase | Pay the quoted USDC on Base and return the unlocked {data, receipt}. Requires env X402_AGENT_PRIVATE_KEY (a Base wallet with >= the quoted USDC + gas). WARNING: this spends real USDC on-chain. |
| verify_receipt | Verify a proof-of-purchase receipt with the gateway (recovers the EIP-191 signer and checks it equals the server's receipt signer). Anyone can call this — no payment required. |
| balance | Check a prepaid balance: remaining balance, calls_remaining, and next_nonce. Pass an address, or leave blank to use the wallet from X402_AGENT_PRIVATE_KEY. |
| topupA | Credit a prepaid balance from an on-chain USDC deposit to the recipient. First send USDC to the recipient on Base, then call this with the tx_hash. |
| spend_gasless | Fetch the paid data by drawing from the prepaid balance — GASLESS, NO on-chain tx. This is the habitual-use path: after one topup you can call this many times for free (only gas-free balance debit). Requires X402_AGENT_PRIVATE_KEY with a funded balance. |
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 1 tool
Only one tool exists, so there is no risk of confusion or overlapping purposes.
With a single tool, naming consistency is inherently maintained; the name 'topup' is concise and action-oriented.
A single tool is insufficient for a payment-related server; essential operations like checking balance or initiating deposits are missing.
The tool requires prior on-chain USDC transfer but provides no tool for that step, leaving a critical gap in the workflow.