Skip to main content
Glama
execution-run

execution-run-mcp

Official
by execution-run
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

execution-run-mcp

Model Context Protocol (MCP) server for the Execute.run bot API. Enables AI agents to manage Shell balances, transfer funds, and execute LLM requests through the Execute.run platform.

Installation

Via npx (Recommended)

npx @execution-run/mcp-server

Via npm

npm install -g @execution-run/mcp-server execution-run-mcp

From Source

git clone https://github.com/execution-run/execution-run-mcp.git cd execution-run-mcp bun install bun run build

Configuration

Set the following environment variables:

  • EXECUTE_RUN_API_KEY (required): Your Execute.run API key from execution.run/api-keys

  • EXECUTE_RUN_API_URL (optional): API base URL (defaults to https://execution.run/v1)

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{ "mcpServers": { "execution-run": { "command": "npx", "args": ["execution-run-mcp"], "env": { "EXECUTE_RUN_API_KEY": "sk_live_your_api_key_here" } } } }

With Kiro

Add to your .kiro/settings/mcp.json:

{ "mcpServers": { "execution-run": { "command": "npx", "args": ["execution-run-mcp"], "env": { "EXECUTE_RUN_API_KEY": "sk_live_your_api_key_here" } } } }

Standalone

EXECUTE_RUN_API_KEY=sk_live_xxx execution-run-mcp

Available Tools

whoami

Get your card and wallet identity information.

Parameters: None

Returns:

{ "cardId": "crd_abc123", "walletId": "exe_xyz789", "address": "bot-prod@exe_xyz789", "balance": 1000, "status": "active" }

get_balance

Get the current Shell balance and ceiling for your wallet.

Parameters: None

Returns:

{ "balance": 1000, "ceiling": 1000000 }

get_transactions

Get transaction history for your wallet.

Parameters:

  • limit (optional): Number of transactions to return (default: 50, max: 100)

Returns:

{ "transactions": [ { "id": "tx_123", "type": "mint", "amount": 1000, "balanceAfter": 1000, "timestamp": { "_seconds": 1706745600 }, "purpose": "Initial credit" } ] }

transfer

Transfer Shells to another wallet.

Parameters:

  • to (required): Recipient wallet ID (exe_xxx) or card address (cardName@exe_xxx)

  • amount (required): Amount of Shells to transfer (positive integer)

  • purpose (required): Purpose/context for the transfer

Returns:

{ "transaction": { "id": "tx_456", "type": "transfer", "amount": 100, "balanceAfter": 900, "purpose": "Payment for service" } }

sign

Sign a challenge with your card's Ed25519 keypair.

Parameters:

  • challenge (required): Base64-encoded challenge to sign

Returns:

{ "signature": "base64_encoded_signature", "cardId": "crd_abc123", "walletId": "exe_xyz789" }

compute

Execute an LLM request by burning Shells.

Parameters:

  • model (required): Model identifier (e.g., 'gemini-2.0-flash', 'gpt-4o', 'claude-3-5-sonnet-latest')

  • messages (required): Array of conversation messages with role and content

  • temperature (optional): Sampling temperature (0-2)

  • maxTokens (optional): Maximum tokens to generate

Returns:

{ "content": "Hello! How can I help you?", "model": "gemini-2.0-flash", "cost": 4 }

Development

# Install dependencies bun install # Build bun run build # Watch mode bun run dev # Run locally bun run start

License

MIT

Links

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/execution-run/execution-run-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server