Back to docs

MCP tool for Claude

Give Claude direct access to AgentCredit. Run credit assessments, look up companies, and check your balance — all from inside Claude Desktop, Claude Code, or any custom Claude agent.

Included in Pro, Team, and Growth plans. Each tool call consumes credits from your account's balance, same as the web chat.

1. Mint an API key

Sign in at agentcredit.net/login, then go to Settings → MCP API keys. Click Create key, give it a memorable name (e.g. “Claude Desktop — laptop”), and copy the resulting ack_… key.

The key is only shown once. If you lose it, revoke it and mint a new one.

2. Connect Claude Desktop

Edit your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the AgentCredit server to mcpServers:

{
  "mcpServers": {
    "agentcredit": {
      "url": "https://agentcredit.net/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY_HERE"
      }
    }
  }
}

Save and restart Claude Desktop. You should see agentcredit in the MCP servers list with three tools available.

3. Connect Claude Code

From your terminal:

claude mcp add agentcredit https://agentcredit.net/mcp \
  -H "Authorization: Bearer YOUR_KEY_HERE"

The next Claude Code session will have AgentCredit's tools available — try asking “Score Tesco Plc as a trade-credit customer.”

Available tools

assess_borrower

Run a credit assessment on a UK company. Returns grade, PD, decision, and persona-specific recommendation. 1 credit per call (refunded on failure).

Args: company_name (required), persona (optional: trade_credit / loan_officer / fx_sales / risk_manager).

lookup_company

Search Companies House for matching UK companies. Returns up to 10 candidates. Free — no credit charge.

Args: query (required).

get_balance

Check your remaining credit balance and current plan. Free.

No arguments.

Security

  • Each key is scoped to a single AgentCredit account.
  • Calls inherit the account's plan, persona, and credit balance.
  • Revoke a key at any time from Settings → MCP API keys; clients using it stop authenticating immediately.
  • Plan downgrades take effect immediately — a user who downgrades to Free starts getting 403 from MCP without re-minting keys.
  • Connections are over HTTPS only. Plain keys never leave the client; the server stores only SHA-256 hashes.

Need help?

Email [email protected] with the key prefix (the first 12 chars, like ack_a1b2c3...) and we'll help debug.