Developers
Connect your AI
Add Beamswap to the AI app you already use. You can connect without sharing a private key, and you approve every paid call and transaction in your wallet.
Choose how to connect
Hosted MCP is the simplest path. The other options suit people who want to run more of it themselves.
Hosted MCP
RecommendedConnect to Beamswap over HTTPS. Approve every paid request in your browser wallet.
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
Paid, approved in your browser
- Token info and portfolios
- Swap quotes and routes
- Distribution proofs
- Watch deletion (costs $0, still asks for approval)
Free, returns a review link
- Limit orders, automations and cross-chain transfers: you sign on beamswap.io
- Watch and distribution status: answers immediately
Create a watch or a distribution through local MCP or the API. You can also create a distribution on the Beamswap website.
- 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.
Set it up in your AI app
Client features and workspace permissions can vary by plan.
ChatGPT
Hosted setupTurn on Developer mode under Settings, Security and login. From Plugins, create a custom connector with no authentication and use the hosted URL.
https://api.beamswap.io/mcpSecure MCP Tunnel access depends on account and workspace permissions.
Client setup sourceTry a prompt
Ask for a result you can review before anything is signed.
“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.”
“Prepare a limit order to buy 500 USDC of WETH on Base if the price drops, and give me the link to review 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.
Not connecting an AI?
Send tokens
Import recipients from a spreadsheet, review the exact total, then create a claim page.
Create a distributionBuild with the API
Call Base data, routing, monitoring and distribution endpoints with x402 payments.
Open API reference