Agent Integrations (MCP)

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" }

Available tools

Once connected, your agent can call every capability of the mag3nt API. Tools are grouped by area below.

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
`webhooks-webhooks-rotate`	Rotate the webhook signing secret (shown once)
`webhooks-webhooks-test`	Send a signed test `payment.settled` delivery
`webhooks-webhooks-list-deliveries`	Paginated delivery log
`webhooks-webhooks-replay-delivery`	Re-POST a stored delivery envelope
`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

Membership, tokens, marketplace, and CT markets

After Speakeasy regenerates MCP from the updated OpenAPI, these areas are also exposed as tools (names follow Speakeasy tagging). Until regeneration lands, call them via the REST API:

Area	Paths
Membership	`/api/membership`, checkout, confirm, cancel, resume, auto-renew
Project tokens	`/api/tokens/register`, `/api/tokens`
Fee meter	`/api/fees/balance`, `/api/fees/deposit`
Billing agreements	`/api/billing/agreements`
Marketplace	`/api/cards/{id}/list`, `/api/listings`, buy/cancel
Credential Tokens	`/api/cards/{id}/crt`, launch-crt, crt-market prepare/confirm
Holdings	`/api/holdings`

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.

Getting Started

Core Concepts

Protocols Deep Dive