Overview
The Model Context Protocol (MCP) is an open standard that lets AI agents use external tools and APIs. The hosted mag3nt MCP server turns the full mag3nt API into agent-native tools, so an assistant can issue cards, check balances, pay endpoints, and reconcile activity on its own.
The server is live at mcp.mag3nt.com. That page also offers one-click install links for popular clients.
Connection URL: https://mcp.mag3nt.com/mcp (modern Streamable HTTP transport). Authenticate with the header api-key-auth: <MAG3NT_API_KEY>. Generate a key from the Developer tab at mag3nt.com. Do not use the legacy https://mcp.mag3nt.com/sse endpoint. The HTTP+SSE transport is deprecated. Always use the /mcp Streamable HTTP endpoint.
Install
Replace mag3nt_live_YOUR_API_KEY with your own key in each example.
Cursor
Open the mcp.mag3nt.com install page and click Cursor for one-click setup, or add it manually under Cursor Settings > MCP:
{
"mcpServers": {
"Mag3nt": {
"command": "npx",
"args": [
"-y",
"mcp-remote@0.1.25",
"https://mcp.mag3nt.com/mcp",
"--header",
"api-key-auth:${API_KEY_AUTH}"
],
"env": {
"API_KEY_AUTH": "mag3nt_live_YOUR_API_KEY"
}
}
}
}
Claude Code
claude mcp add --transport http Mag3nt https://mcp.mag3nt.com/mcp --header "api-key-auth:mag3nt_live_YOUR_API_KEY"
Claude Desktop
Open Settings > Developer > Edit Config, then merge this into the mcpServers object in claude_desktop_config.json and restart Claude Desktop:
{
"mcpServers": {
"Mag3nt": {
"command": "npx",
"args": [
"-y",
"mcp-remote@0.1.25",
"https://mcp.mag3nt.com/mcp",
"--header",
"api-key-auth:${API_KEY_AUTH}"
],
"env": {
"API_KEY_AUTH": "mag3nt_live_YOUR_API_KEY"
}
}
}
}
VS Code
Use the install link on mcp.mag3nt.com, or add the same Mag3nt server entry shown above to your VS Code MCP configuration.
Gemini CLI
gemini mcp add --transport http Mag3nt https://mcp.mag3nt.com/mcp --header "api-key-auth:mag3nt_live_YOUR_API_KEY"
Codex CLI
Add this to your Codex config:
[mcp_servers.Mag3nt]
url = "https://mcp.mag3nt.com/mcp"
http_headers = { "api-key-auth" = "mag3nt_live_YOUR_API_KEY" }
Cards
| Tool | What it does |
|---|
cards-cards-create | Issue a virtual card backed by treasury balance |
cards-cards-bulk-create | Issue up to 1,000 cards in one atomic request |
cards-cards-list | List all cards for the wallet |
cards-cards-list-transactions | A single card’s transaction history |
cards-cards-top-up | Add funds to an active card from treasury |
cards-cards-freeze | Block all spending on a card |
cards-cards-unfreeze | Resume spending on a frozen card |
cards-cards-claim | Move a card’s unspent funds back to treasury (full or partial sweep) |
cards-cards-close | Retire an empty card with no open obligations |
cards-cards-update-controls | Update MCC locks and single-use settings |
transactions-list-account | Wallet activity across every card, including closed ones |
Payments
| Tool | What it does |
|---|
payments-payments-execute | Pay any x402, AP2, or MPP endpoint with a card; auto-detects the protocol and settles on-chain |
Funding and withdrawals
| Tool | What it does |
|---|
funding-funding-get-balance | Treasury balance for the wallet |
funding-funding-list-tokens | Accepted tokens per network |
funding-funding-verify | Credit treasury from an on-chain funding transaction |
funding-funding-get-wallet-balance | Real-time on-chain balance for any address |
withdrawals-withdrawals-create | Withdraw treasury funds to a wallet |
withdrawals-withdrawals-list | Withdrawal history |
Pay links
| Tool | What it does |
|---|
pay-links-pay-links-create | Create a shareable payment link |
pay-links-pay-links-list | List your pay links |
pay-links-pay-links-get | Get public pay link details |
pay-links-pay-links-cancel | Cancel a pay link |
pay-links-pay-links-get-status | Check payment status |
pay-links-pay-links-resolve | Resolve a link for processing |
pay-links-pay-links-prepare | Discover payment requirements |
pay-links-pay-links-settle | Submit on-chain settlement proof |
Protocols
| Tool | What it does |
|---|
x402-x402-discover | Discover x402 payment requirements for a URL |
x402-x402-receive | Verify and accept an x402 payment |
ap2-ap2-get-agent-card | Get the default agent card for AP2 |
ap2-ap2-list-payment-methods | List AP2 payment methods |
ap2-ap2-create-mandate | Create a spending mandate for recurring payments |
ap2-ap2-execute | Execute a payment against a mandate |
ap2-ap2-list-mandates | List a card’s mandates |
ap2-ap2-settle | Settle an AP2 payment between agents |
mpp-mpp-create-session | Create an MPP payment session |
mpp-mpp-discover | Discover MPP capabilities for a URL |
mpp-mpp-receive | Verify and accept an MPP payment |
mpp-mpp-streams-open | Open a payment stream for continuous micropayments |
mpp-mpp-streams-tick | Advance a payment stream by one tick |
mpp-mpp-streams-close | Close a payment stream |
mpp-mpp-streams-get | Get payment stream details |
Keys, webhooks, and status
| Tool | What it does |
|---|
keys-keys-create | Generate an API key (returned once) |
keys-keys-list | List API keys |
keys-keys-revoke | Revoke an API key |
keys-keys-validate | Validate an API key |
webhooks-webhooks-create | Register a signed payment.settled webhook |
webhooks-webhooks-list | List registered webhooks |
webhooks-webhooks-delete | Delete a webhook |
settlement-settlement-get-status | Check settlement status for a transaction |
status-status-get | Platform status, protocols, and capabilities |
status-status-get-config | Treasury addresses and token registry |
Try it
Once connected, ask your agent something like:
Issue a card for $10, use it to pay for data from weather-api.com, then move any unspent funds back to my treasury and close the card.
The agent will call cards-cards-create, payments-payments-execute, cards-cards-claim, and cards-cards-close in sequence, with the full record available through transactions-list-account.
