Use ToRun in Claude Code

Before you start

Create a developer key and save it in an environment variable named TORUN_API_KEY: see Developer keys.

Add ToRun to Claude Code

Run this in a terminal:

claude mcp add --transport http torun https://mcp.torun.ai/mcp --header "Authorization: Bearer $TORUN_API_KEY"

Your shell puts the key into the command, and Claude Code keeps it in its own settings on your computer.

Share the setup with a project

To keep the server in a project's .mcp.json, which is usually committed, refer to the variable there instead of the key. Each person then uses their own key:

{
  "mcpServers": {
    "torun": {
      "type": "http",
      "url": "https://mcp.torun.ai/mcp",
      "headers": { "Authorization": "Bearer ${TORUN_API_KEY}" }
    }
  }
}

Check that it works

In Claude Code, /mcp lists your servers: torun should be connected. Then ask:

What is my ToRun balance?

Claude calls account_balance and answers with your plan allowance, your wallet and this key's limit. This call is free.

Ask for what your project needs

Make three 512x512 icons for the settings, profile and help buttons in a flat style and save them to public/icons.

Record a short welcome line in a warm voice and save it to assets/welcome.mp3.

Paid calls are charged to your ToRun account: see how calls are paid.