Carbon DeFi

For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs; this page is available as Markdown.

AI Agents & MCP Server

Carbon DeFi has an MCP (Model Context Protocol) server that allows AI agents to create and manage on-chain trading strategies programmatically.

{% hint style="info" %} Experimental — still being worked on. Use at your own risk. {% endhint %}

• MCP endpoint: https://mcp.carbondefi.xyz
• REST API: https://mcp.carbondefi.xyz/tools/:toolName
• OpenAPI spec: https://mcp.carbondefi.xyz/openapi.json
• Plugin manifest: https://mcp.carbondefi.xyz/.well-known/ai-plugin.json
• Server info: https://mcp.carbondefi.xyz/info

Claude Desktop setup

Add this to your Claude Desktop config to connect:

json

{
  "mcpServers": {
    "carbon-defi": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.carbondefi.xyz"]
    }
  }
}

Key conventions for agents

• All write operations return unsigned transactions — the user always signs and broadcasts
• Always call get_strategies first to check existing positions
• Market price is auto-fetched from the Carbon API — no need to provide it manually
• Prices are always in quote token per 1 base token
• buy_budget is always in quote token; sell_budget is always in base token
• Check the warnings array in every response before presenting a transaction