Docs menu

MCP

Add Andru to your MCP client

In Claude, connect to Andru at https://mcp.andru-ai.com/mcp and sign in with your Andru account: no key and nothing to install. Other clients can run the mcp-server-andru-intelligence package (version 2.0.2) on your computer with an API key. Either way you get 35 tools and 1 resource, answered from your Andru account.

Connect in Claude

Works on every Claude plan; on the Free plan you can add one custom connector.

  1. 1In Claude, go to Customize › Connectors and click Add custom connector.
  2. 2Name it Andru and enter https://mcp.andru-ai.com/mcp.
  3. 3If Claude asks how people sign in, choose Sign in when needed and Use Claude's published identity. Leave the client ID and secret blank.
  4. 4Click Add, then Connect, and sign in to Andru.
  5. 5On Connect Claude to Andru, answer How much can Claude spend without asking you?, then click Connect.
  6. 6In a chat, click + › Connectors and turn Andru on.

Andru needs to know what you sell first. In your first chat, give Claude your company website, like acme.com, and Claude passes it to Andru. Andru reads it once and uses it for every later call. No website yet? A sentence or two on what you sell and who buys it works too.

On a Team or Enterprise plan, an Owner adds Andru once under Organization settings › Connectors › Add › Custom › Web; then each person connects from Customize › Connectors.

Lookups are free, plus 5 free calls a day shared across A2A and MCP. You can change this or disconnect Claude any time in Settings → API access. Andru charges only when a result is delivered, and returns the money if a job fails.

Add to Cursor or VS Code

One click adds Andru's hosted server to Cursor or VS Code: no key and nothing to install. You sign in with your Andru account before any tool runs.

Both add this server: https://mcp.andru-ai.com/mcp?signin=first. If a button doesn't open your app, add that exact address, including ?signin=first, in the app's MCP settings.

Run it locally (Claude Desktop config, Cursor and other clients)

Requirements

Node.js 18 or later, and an API key from Settings › Developer. Each client starts the server itself with npx; nothing else to install.

Claude Desktop

Open Settings › Developer › Edit Config, add Andru, save, and restart Claude Desktop.

claude_desktop_config.json
{
  "mcpServers": {
    "andru": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-andru-intelligence"
      ],
      "env": {
        "ANDRU_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor

Add the same entry to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).

~/.cursor/mcp.json
{
  "mcpServers": {
    "andru": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-andru-intelligence"
      ],
      "env": {
        "ANDRU_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Claude Code

Connect to the hosted server, then sign in:

Terminal
claude mcp add --transport http andru https://mcp.andru-ai.com/mcp

Then run /mcp in Claude Code and sign in to Andru. Or run the package locally with a key:

Terminal
claude mcp add andru -e ANDRU_API_KEY=sk_live_your_key_here -- npx -y mcp-server-andru-intelligence

Settings

VariableDefaultWhat it does
ANDRU_API_KEYNone (required)Your API key. Without it the tools are listed but cannot run.
ANDRU_API_URLhttps://api.andru-ai.comThe Andru API address. Leave it unset.
ANDRU_CACHEOnKeeps recent answers in a local cache at ~/.andru/cache.db. Set to false to turn it off.

What it costs

MCP and A2A share one price list and one wallet. Lookups are always free. On top of that, 5 free calls a day, shared across A2A and MCP, cover quick thesis checks ($3). Catalog assets are always paid. Calls that only ask for more information never count. Every tool's price is on the tools page.

Troubleshooting

What you seeWhat to do
“Sign in to Andru to use this tool.”The tool needs your Andru account. In Claude, click Connect on the Andru connector (in Claude Code, run /mcp) and sign in.
The connector still says Connect after you signed inThe sign-in didn't finish. Click Connect and sign in again. If it keeps happening, tell us at andru-ai.com/support.
“could not determine executable to run”An older copy (1.6.0 or earlier) is cached. Use mcp-server-andru-intelligence@latest in the args once, or run npx clear-npx-cache.
Tools listed, but every call failsThe key is missing or revoked. Check ANDRU_API_KEY and create a new key if needed.
“Insufficient funds”The call is paid and the free allowance is used up. Top up the wallet in Billing.
A tool asks what you sellTell it once with set_product_context (your website is enough). Clients that support forms ask you directly.
“No ICP profile found”Run Pure Signal in Andru first; profile tools answer from it.