MCP Integration

Use Execution.run with AI agents via the Model Context Protocol.

What is MCP?

The Model Context Protocol is a standard for connecting AI agents to external tools and services. Our MCP server lets agents access LLMs through your wallet using a Card API key.

Setup

Add to your MCP config (e.g., .kiro/settings/mcp.json):

{
  "mcpServers": {
    "execution-run": {
      "command": "npx",
      "args": ["@execution-run/mcp-server"],
      "env": {
        "EXECUTE_RUN_API_KEY": "sk_live_your_card_key"
      }
    }
  }
}

Available Tools

Tool	Description
`whoami`	Get card and wallet identity
`get_balance`	Check your wallet's Shell balance
`get_transactions`	View transaction history
`transfer`	Send Shells to another wallet or card address
`sign`	Sign a challenge with your card's keypair
`compute`	Execute an LLM request

Card Identity

Each card has its own Ed25519 keypair for cryptographic identity. Use the sign tool to prove your card's identity to other services.

Your card address format: cardName@walletId

Environment Variables

Variable	Required	Description
`EXECUTE_RUN_API_KEY`	Yes	Your Card API key
`EXECUTE_RUN_API_URL`	No	Custom API URL