Skip to content
Get started Dashboard

ToolsMCP server

Swaps, as tools for your agent.

Your agent reads, prices and prepares. You send and sign.

Serverhttps://mcp.agent.swaps.app/mcp

Connect Read the docs

What an agent can do.

The same account, the same rules, one product at a time.

  • Payment links

    Draft a request, send it to the payer, see when it is paid.

    • create_payment_request
    • send_payment_request
    • check_payment_request

  • Invoices and payouts

    Prepare a supplier payout and read where it stands.

    • prepare_invoice_payout
    • get_payout
    • list_payouts

  • Payroll

    Prepare a pay run for a person to review and fund.

    • prepare_payroll_run
    • get_payroll_run

  • Wallet

    Read the balance and the activity of a Swaps Wallet.

    • get_wallet_balance
    • list_wallet_activity

  • Buy and sell

    Price a route and read an order’s status.

    • get_quote
    • get_order_status

  • Addresses

    Address check

    Check an address, inspect a transaction, trace where funds went.

    • check_address_risk
    • inspect_transaction
    • trace_transaction

ReadsPrepares a draftNeeds the call to confirm

What no tool can do.

  • Send or sign a payment.
  • Refund.
  • Activate a payment link.
  • Add bank details.
  • Run or fund payroll.

Three ways in.

  1. Your account

    The hosted server, with a business key in the Authorization header.

    claude mcp add --transport http swaps https://mcp.agent.swaps.app/mcp

    Keys are by invitation today.

    How to get a key

  2. On your machine

    Read-only route tools. No key.

    npx -y @agent.swaps/mcp-server

    See the package

  3. In ChatGPT

    Swaps Wallet Screen: one address check. No key.

    Check a wallet address in ChatGPT

For machines

Where a robot looks.

Machine-readable files
swaps.app/llms.txtThe site, as a list for language models.
swaps.app/.well-known/agent-skills/index.jsonThe skills an agent can install.
docs.swaps.app/openapi.jsonThe /v1 API these tools call.
docs.swaps.app/agents-mcp.mdThis server, in plain text.

FAQ

Questions.

Can an agent move money on its own?

No. No tool can send, sign, refund or activate. A tool that touches a money step is refused unless the call confirms it, and money moves only when a person sends funds or signs.

How do I get a key?

The account tools need a Swaps business key. Keys are by invitation today: ask for access in Developers in your dashboard.

Is there a test mode?

Not for these tools today. Test keys cover keys, request logs, webhooks and events; the account tools answer them as unavailable.

Which clients can connect?

Any client that speaks MCP over HTTP and can send an Authorization header. Our docs carry the setup for Claude Code, Cursor and Codex.

How is this different from the ChatGPT plugin?

The plugin, Swaps Wallet Screen, runs on its own server with one tool and no key: it checks one public address. This server works with your Swaps account.

Is there a version that runs on my machine?

Yes. The npm package @agent.swaps/mcp-server runs locally with read-only route tools and no key. It has no account tools.

Related: ChatGPT plugin · Developers · Address check · Docs