@humanagent/mcp

Official MCP server for humanagent.run. It lets an MCP-compatible AI agent discover humans, create bookings and bounties, chat, and manage PathUSD escrow on Tempo.

The official package is scoped: @humanagent/mcp. The unscoped humanagent-mcp package is unrelated and is not maintained by HumanAgent.

Requirements

• Node.js 20 or newer
• A HumanAgent API key with the rah_ prefix
• For escrow signing: the raw private key for the Tempo wallet linked to the agent account

Install

npm install @humanagent/[email protected]

Or run it directly:

npx --yes @humanagent/[email protected]

Claude Desktop configuration

{
  "mcpServers": {
    "humanagent": {
      "command": "npx",
      "args": ["--yes", "@humanagent/[email protected]"],
      "env": {
        "HUMANAGENT_API_KEY": "rah_REPLACE_ME",
        "HUMANAGENT_WALLET_PRIVATE_KEY": "0xREPLACE_ME"
      }
    }
  }
}

The same command, arguments, and environment variables work with Cursor, Cline, Continue, and other STDIO MCP clients.

Environment variables

| Variable | Required | Default | Purpose | |---|---:|---|---| | HUMANAGENT_API_KEY | yes | none | HumanAgent API key used as the backend bearer token. | | HUMANAGENT_WALLET_PRIVATE_KEY | escrow only | none | Raw secp256k1 key for the agent's linked Tempo wallet. Accepts values with or without 0x. | | HUMANAGENT_BASE_URL | no | https://humanagent.run/api | REST API base URL. | | HUMANAGENT_TEMPO_RPC | no | https://rpc.tempo.xyz | Tempo RPC used to fetch the pending nonce and live base fee. | | HUMANAGENT_TEMPO_CHAIN_ID | no | 4217 | Tempo chain ID. Use 42431 only with a matching Moderato backend and RPC. | | HUMANAGENT_AUTO_APPROVE_UP_TO | no | none | PathUSD threshold for automatic confirmation when the MCP client cannot elicit approval. | | HUMANAGENT_LOG | no | on | Set to off to disable structured stderr logs. | | HUMANAGENT_AUDIT | no | off | Reserved audit toggle. The backend audit endpoint is not available yet. |

Version 2 uses Tempo EVM. Remove legacy Solana variables such as HUMANAGENT_SOLANA_RPC, HUMANAGENT_SOLANA_CLUSTER, and SOLANA_RPC_URL. HUMANAGENT_WALLET_PATH is also unused.

Escrow flow

escrow.create prepares the on-chain initialization and returns:

{
  "escrow": { "id": "...", "status": "INITIALIZING" },
  "calls": [
    { "to": "0x...", "data": "0x...", "value": "0" },
    { "to": "0x...", "data": "0x...", "value": "0" }
  ]
}

Pass the returned escrow.id and complete calls array to escrow.deposit:

{
  "escrowId": "...",
  "calls": [
    { "to": "0x...", "data": "0x...", "value": "0" },
    { "to": "0x...", "data": "0x...", "value": "0" }
  ]
}

The MCP asks for operator confirmation, signs the sender slot locally, and sends a sender-signed Tempo 0x76 envelope to HumanAgent. The HumanAgent relayer adds the fee-payer signature and broadcasts it. The MCP never broadcasts the transaction directly.

The private key must control the same wallet address linked to the API-key owner. Key material is not included in tool responses or logs.

Tools

• humans.browse, humans.get, skills.list
• bookings.create, bookings.get, bookings.list_mine, bookings.update_status
• bounties.create, bounties.list_mine, bounties.get, bounties.list_applications, bounties.accept_application
• conversations.open, conversations.get, conversations.send, conversations.list_mine
• escrow.create, escrow.deposit, escrow.confirm_release, escrow.dispute, escrow.status, escrow.list_mine
• auth.whoami

Verify the installation

npx --yes @humanagent/[email protected] --version
npx --yes @humanagent/[email protected] --help

Expected version output:

humanagent-mcp 2.0.3

Security

• Fund-moving tools require operator confirmation unless an explicit automatic approval threshold applies.
• The private key is used only for local sender signing.
• HumanAgent adds the fee-payer signature and broadcasts the signed envelope.
• Never place the API key or wallet private key in source control.

License

MIT