Agent Setup — Bounty API

Step 1: Install Bounty MCP

Connect your agent to Bounty's API catalog via MCP (Model Context Protocol).

npm (global install)

# Install and run
npx bountyapi-mcp

# Or add to your MCP config:
{{
  "mcpServers": {{
    "bounty": {{
      "command": "npx",
      "args": ["-y", "bountyapi-mcp"]
    }}
  }}
}}

Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client. Also available as HTTP transport at /mcp

Step 2: Fund a Base wallet

Premium endpoints cost USDC on Base. Fund a wallet your agent controls.

Create a walletMetaMask, Rabby, or Coinbase Wallet. Select Base network.

Get USDC on BaseBridge USDC from Ethereum, or buy directly on Base via Coinbase.

Give agent the private keySet as environment variable. Agent signs payments autonomously.

Test with small amountsStart with $1 USDC. Each call costs $0.005-$0.01.

Agent wallet config

# Environment variables for x402
AGENT_WALLET_KEY=0x...your_private_key
AGENT_WALLET_ADDRESS=0x...your_address
X402_NETWORK=eip155:8453  # Base

Compatible agents

Claude Desktop

Add Bounty to your MCP config file. Claude can then discover and call any Bounty endpoint. Free endpoints work immediately. Paid endpoints need a wallet.

Cursor / Windsurf

Settings → MCP → Add server. Paste the npx config. Your AI coding assistant can now call data APIs inline.

Custom agents

Any agent that speaks MCP or HTTP can use Bounty. For HTTP, hit endpoints directly. For x402, use the x402 client SDK to handle payment negotiation.

ChatGPT / GPT

Use the HTTP transport at https://bountyapi.com/mcp or call free endpoints directly via URL fetch. Paid endpoints require an x402 client.

Quick test (no wallet needed)

# Free endpoints work without payment:
curl https://bountyapi.com/bsd?price=2000000
curl https://bountyapi.com/currency/convert?from=USD&to=SGD&amount=100
curl https://bountyapi.com/mortgage/calculate \
  -X POST -H "content-type: application/json" \
  -d '{{"principal":500000,"annual_interest_rate":3.5,"loan_term_years":30}}'

# MCP discovery (stdio):
npx bountyapi-mcp

# MCP discovery (HTTP):
curl -X POST https://bountyapi.com/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{{"jsonrpc":"2.0","id":1,"method":"initialize","params":{{"protocolVersion":"2024-11-05","capabilities":{{}},"clientInfo":{{"name":"test","version":"1.0"}}}}}}'