From install to your first paid call

Part 1: a paid read, no wallet

1. Install a payment client

   Any x402 client works. This guide uses AgentCash, an MCP server that pays x402 APIs from its own USDC wallet. Its guided installer sets it up for your agent:

   npx agentcash install

   Or add it to Claude Code directly:

   claude mcp add agentcash --scope user -- npx -y agentcash@latest

2. Fund it with a little USDC on Base

   AgentCash creates its wallet the first time it runs. Ask your agent for the deposit address (AgentCash's list_accounts tool) and send USDC on Base to it. A market search costs $0.001.

3. Make the call

   Ask your agent:

   Use AgentCash to search Polymarket on chainhilt.ai for markets about bitcoin.

   Or have it fetch the endpoint directly:

   GET https://chainhilt.ai/api/v1/predict/polymarket/markets/search?query=bitcoin&limit=5

   The first answer is 402 Payment Required with the price. AgentCash pays $0.001 and repeats the request, and the response lists the matching markets with their outcomes, prices and token IDs.

You are done when your agent shows the markets and the AgentCash balance is $0.001 lower.

Part 2: sign and submit with the wallet

Anything that moves funds or places an order comes back as unsigned actions. The ChainHilt wallet signs them on your machine; the server never holds a key.

4. Install the wallet

   npx -y chainhilt@latest init

   It registers the wallet MCP with the agent clients you pick and installs its skill. Reload your agent, which can then call mcp_status. If something is off, npx -y chainhilt@latest doctor checks registration and connectivity.

5. Create or import a key, then fund it

   npx -y chainhilt@latest wallet setup

   This opens a private page served only on your machine, where you create a wallet or import a key, and then shows its receive address. Never paste a private key into chat. This wallet pays for the operation itself (tokens and gas), while AgentCash pays only the API fees, so fund each for its own job.

6. Authorize, request, execute

   Every signed operation follows the same three calls:

   1. The wallet's authorize_request, with the exact method, URL and JSON body.
   2. The request itself, through AgentCash, with the X-ChainHilt-Authorization header it returned.
   3. The wallet's process_action, with the actions' verification.nonce and hashes. It checks each action against what ChainHilt issued for that request, then signs and sends it.

   For example, ask your agent to swap 1 USDC for ETH on Base. It authorizes and calls POST /api/v1/swap/execute ($0.01) and shows you the quote. Once you confirm, the wallet sends the approval and then the swap.

Next

• Swap tokens: quotes across aggregators, executed from your wallet.
• Bridge tokens: routes from a list of bridges, sent from your wallet and tracked until they land.
• Trade on Hyperliquid: orders, TWAPs, leverage, transfers and portfolio checks.
• Trade on Polymarket: market data, account setup and limit orders.
• The API reference, and skills.md, the guide your agent reads.