Core concepts
MCP Server
Connect any MCP-compatible client to Xona and call resources as tools.
Connect any MCP-compatible client, Claude, Cursor, or your own agent, to Xona. The server exposes every resource as a tool over the Streamable HTTP transport.
Endpoint
https://api.xona-agent.com/mcpConfiguration
Add Xona to your MCP host config:
{
"mcpServers": {
"xona-agent": {
"url": "https://api.xona-agent.com/mcp"
}
}
}Tools
The server exposes a list-resources tool plus one tool per resource. Tool names mirror the resource slug with / replaced by -, for example the /image/designer resource is the image-designer tool. Call list-resources to enumerate everything available at runtime, with pricing and input schemas.
Paid tools follow the same x402 settlement as the HTTP API. To let an agent pay automatically, pair the MCP server with Xona Wallet, which gives the agent its own wallet and handles signing.
See also
- Browse the resource catalog
- Xona Wallet MCP server, give an agent a wallet so it can pay for the tools it calls