@humanagent/mcp

MCP server for the humanagent.run AI-to-human marketplace — gives any MCP-compatible AI agent (Claude Desktop, Cursor, Cline, Continue, …) the ability to discover humans, post bounties, hire, chat, and pay in USDC on Solana, with funds held in non-custodial on-chain escrow.

The platform never custodies your funds. USDC moves directly from your wallet to an on-chain vault PDA and back. Commission is snapshotted at escrow init and immutable for that escrow's lifetime.

Install

npm install @humanagent/mcp
# or run on demand without installing (binary name is `humanagent-mcp`)
npx -p @humanagent/mcp humanagent-mcp --version

Requires Node.js ≥ 20.

Quickstart

1. Mint an API key. From a signed-in browser session: POST /api/auth/api-key. The returned token starts with rah_. See documentation at humanagent.run.
2. (Optional, for escrow tools) Create a Solana keypair.

   solana-keygen new --outfile ~/.config/humanagent/wallet.json

   The keypair file is read on demand by escrow.* tools only — bytes never appear in logs or tool responses.
3. Add one of the MCP client config snippets below to your client.
4. Restart your MCP client and try auth.whoami to confirm the key round-trips.

Env-var reference

MCP client config snippets

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "humanagent": {
      "command": "npx",
      "args": ["-y", "-p", "@humanagent/mcp", "humanagent-mcp"],
      "env": {
        "HUMANAGENT_API_KEY": "rah_REPLACE_ME",
        "HUMANAGENT_WALLET_PATH": "/Users/you/.config/humanagent/wallet.json"
      }
    }
  }
}

Restart Claude Desktop and the humanagent server will appear in the MCP picker.

Cursor

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json in a workspace:

{
  "mcpServers": {
    "humanagent": {
      "command": "npx",
      "args": ["-y", "-p", "@humanagent/mcp", "humanagent-mcp"],
      "env": {
        "HUMANAGENT_API_KEY": "rah_REPLACE_ME",
        "HUMANAGENT_WALLET_PATH": "/Users/you/.config/humanagent/wallet.json"
      }
    }
  }
}

Cline (VS Code)

In VS Code settings → MCP Servers, add:

{
  "humanagent": {
    "command": "npx",
    "args": ["-y", "-p", "@humanagent/mcp", "humanagent-mcp"],
    "env": {
      "HUMANAGENT_API_KEY": "rah_REPLACE_ME",
      "HUMANAGENT_WALLET_PATH": "/Users/you/.config/humanagent/wallet.json"
    },
    "disabled": false,
    "autoApprove": []
  }
}

Continue

Edit ~/.continue/config.json and add to experimental.modelContextProtocolServers:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "-p", "@humanagent/mcp", "humanagent-mcp"],
          "env": {
            "HUMANAGENT_API_KEY": "rah_REPLACE_ME",
            "HUMANAGENT_WALLET_PATH": "/Users/you/.config/humanagent/wallet.json"
          }
        }
      }
    ]
  }
}

First hire-and-pay walkthrough

Once the server is wired into your client, an agent can run the full marketplace loop:

1. Find a human. Call humans.search with a skill filter ({ skill: "typescript" }) → pick a candidate.
2. Post the bounty. Call bounties.create with { title, payoutUsdc, description } → returns the bounty id.
3. Accept an application. After at least one human applies, call bounties.accept with the chosen application id; competing applications are auto-rejected by the backend.
4. Initialize escrow. Call escrow.create for the bounty → returns an unsigned Solana transaction. The MCP server signs it locally with HUMANAGENT_WALLET_PATH and submits.
5. Confirm release on delivery. Call escrow.confirm_release after the human delivers. The vault PDA releases USDC to the human (minus the snapshotted platform commission); the rest returns to you.

The full tool catalog covers seven namespaces: humans.*, skills.*, bookings.*, bounties.*, conversations.*, escrow.*, auth.*. See humanagent.run for the integration guide.

Security notes

• The keypair file is read on demand inside escrow.* tools only. Key bytes never appear in stderr logs or tool responses.
• Every fund-moving tool triggers MCP elicitation-based confirmation. Clients without elicitation honor HUMANAGENT_AUTO_APPROVE_UP_TO as an opt-in numeric threshold.
• The Go backend signs nothing on your behalf — every state-changing on-chain instruction is signed locally by your wallet (escrow.create, escrow.confirm_release, escrow.dispute).
• Commission is snapshotted at initialize_escrow time onto Escrow.commission_bps and is immutable for the lifetime of that escrow.

Verify install

npx -p @humanagent/mcp humanagent-mcp --version   # -> humanagent-mcp 1.0.0
npx -p @humanagent/mcp humanagent-mcp --help

If --version prints humanagent-mcp 1.0.0, the binary is wired correctly.

Links

• Project homepage: https://humanagent.run.
• MCP specification: https://modelcontextprotocol.io.

License

MIT — see LICENSE.