Start here

What do you want to do?

Pick a path. You can connect an AI without sharing a private key, prepare a token claim page, or integrate the API directly.

Use your AI

Connect an AI client through hosted MCP or run the local server yourself.

Choose a connection

Send tokens

Import recipients from a spreadsheet, review the exact total, then create a claim page.

Create a distribution

Build with the API

Call Base data, routing, monitoring and distribution endpoints with x402 payments.

Open API reference

CONNECT YOUR AI

Choose how Beamswap connects.

Hosted MCP is the simplest path. Compare every option before choosing how much infrastructure and payment automation you want to manage.

Hosted MCP

Recommended

Connect to Beamswap over HTTPS. Approve every paid request in your browser wallet.

Good fit

No private key in client configuration. Works anywhere the client accepts remote MCP.

Tradeoff

A browser approval is required for each paid call.

Hosted MCP URL

https://api.beamswap.io/mcp

The AI requests a tool. Beamswap opens a browser approval page for paid calls. Review the tool, price and wallet request before approving. Free calls need no payment approval.

Initial hosted tools

Token info, portfolios, swap quotes and routes, and distribution proofs use browser approval. Watch and distribution status return immediately. Watch deletion costs $0 but still asks for explicit approval. Create a watch through local MCP or the API. Create a distribution on the Beamswap website, through local MCP, or through the API.

CLIENT GUIDE

Pick the app you use.

AI client

Client features and workspace permissions can vary by plan.

ChatGPT

Hosted setup

Turn on Developer mode under Settings, Security and login. From Plugins, create a custom connector with no authentication and use the hosted URL.

ChatGPT setup

https://api.beamswap.io/mcp

Secure MCP Tunnel access depends on account and workspace permissions.

Client setup source

TRY A PROMPT

Ask for a reviewable result.

“Compare routes to swap 0.1 ETH for USDC on Base. Show me the result for review and do not broadcast.”

“Summarize this Base wallet and tell me which balances have an available USD value.”

“Prepare a price alert for this token and explain the threshold before creating it.”

Keep wallet control

Review every browser approval, route and transaction. A swap route is prepared for your wallet to sign and is never broadcast automatically. Local MCP payment keys belong only in local configuration, never in a prompt.

Full client guides Compare access methods