AI agents (MCP)

1. Make a token

On your Account page, create an API token. It acts as you — keep it like a password. It is shown once.

2. Connect

claude mcp add --transport http forkstate https://forkstate.forkscout.com/api/mcp \
  --header "Authorization: Bearer $FORKSTATE_TOKEN"

{
  "mcpServers": {
    "forkstate": {
      "url": "https://forkstate.forkscout.com/api/mcp",
      "headers": { "Authorization": "Bearer <your token>" }
    }
  }
}

3. Ask

Things agents do well with it:

• “Fork Base, give 0xabc… a million USDC, and check whether this swap reverts.”
• “Deploy my contract, verify it, and explain why the last transaction failed.”
• “Simulate approve then deposit as one bundle and tell me the gas.”

Tools

• list_testnets / list_chainsWhat exists, and what can be forked
• create_testnet / delete_testnetMake or remove a testnet
• clone_testnetCopy a testnet exactly into a new one
• create_testnet · tagsTag a testnet with what it is for — CI, Audit, Demo — and see the tags in list_testnets
• snapshot_testnet / list_snapshots / restore_snapshot / delete_snapshotSave state under a name and go back to it
• fund / set_token_balanceGive any address native tokens or any ERC-20
• set_oracle_priceMake a Chainlink feed report any price
• simulate / simulate_bundleOne call, or a sequence, without committing
• sendSend a transaction from any address
• explain_transaction / recent_transactionsWhat happened, decoded
• read_contract_stateCall view functions
• verify_contractVerify source so calls and errors are decoded
• create_alert / list_alerts / test_alert / delete_alertWebhooks on a testnet
• balance / usageCredit left, and what each testnet cost