@halo/mcp-server

@halo/mcp-server exposes HALO as an MCP server so any MCP-compatible agent can create agents, check balances, send payments, and manage testnet wallets.

Quick start

HALO_API_KEY=halo_sk_test_xxx npx @halo/mcp-server

What it does

The server exposes 8 tools for any MCP-compatible agent:

• check_balance: Check the current HALO wallet balance
• send_payment: Create a USDC payment intent
• get_payment_status: Look up the latest status for an intent
• pay_402_resource: Pay an x402-protected HTTP resource
• list_agents: List HALO agents available to the API key
• create_agent: Create a new HALO agent and return its credentials
• fund_wallet: Fund a testnet wallet with gas and USDC
• toggle_kill_switch: Pause or resume payments on a chain

Configuration

Claude Desktop

{
  "mcpServers": {
    "halo": {
      "command": "npx",
      "args": ["-y", "@halo/mcp-server"],
      "env": {
        "HALO_API_KEY": "halo_sk_test_xxx"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "halo": {
      "command": "npx",
      "args": ["-y", "@halo/mcp-server"],
      "env": {
        "HALO_API_KEY": "halo_sk_test_xxx"
      }
    }
  }
}

ChatGPT

Use a stdio MCP server entry with:

• command: npx
• args: ["-y", "@halo/mcp-server"]
• env: HALO_API_KEY=halo_sk_test_xxx

Environment variables

• HALO_API_KEY: Required HALO agent API key
• HALO_API_URL: Optional HALO backend override. Defaults to production

Tool reference

check_balance

Optional input: chain

Returns the wallet balance in micro-USDC plus address and chain.

send_payment

Input: amountMicroUsdc, recipientAddress, optional chain

Creates a HALO native payment intent.

get_payment_status

Input: intentId

Returns the latest status, amount, recipient, chain, and any transaction hash.

pay_402_resource

Input: resourceUrl

Pays an x402-protected resource through HALO and returns the result.

list_agents

No input.

Returns all agents available to the current key.

create_agent

Input: name, optional chain

Creates a new HALO agent and returns its API key and wallet address.

fund_wallet

Input: walletId

Funds a testnet wallet with gas and USDC.

toggle_kill_switch

Input: chain, enabled

Pauses or resumes payments on a specific chain.