# Bobby Protocol — AI Integration Guide

Bobby is a Base-native accountability protocol for autonomous finance. Three agents debate every call, a deterministic risk gate can veto it, and the decision is committed before its outcome. Resolution uses signed oracle evidence and missed stops can be challenged permissionlessly.

Production is Base mainnet only (chain 8453). Bobby holds no funds, asks for no exchange credentials, and exposes no centralized-exchange execution rail.

## Quick start

```bash
claude mcp add bobby-trader https://bobbyprotocol.xyz/api/mcp-bobby

curl -X POST https://bobbyprotocol.xyz/api/mcp-bobby \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"bobby_stats","arguments":{}},"id":1}'
```

## Public MCP tools

The production endpoint currently exposes 6 tools:

- `bobby_analyze` — multi-source market analysis with AI synthesis
- `bobby_debate` — Alpha Hunter vs Red Team vs CIO
- `bobby_ta` — deterministic technical analysis
- `bobby_intel` — compact market-intelligence snapshot
- `bobby_uniswap_quote` — read-only Uniswap V3 quote on Base
- `bobby_stats` — public track record and performance metrics

Discover the live schema instead of relying on this list:

```json
{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}
```

## Base mainnet contracts

| Contract | Address | Purpose |
|---|---|---|
| BobbyTrackRecord V2 | `0x822DB0DbbCAB398e610fcBA86DA9BB92d2493321` | Future-anchored, oracle-verified record |
| BobbyConvictionOracle | `0x27f51D711171c830dd796D4B03914a8C6c46D75e` | Pre-execution conviction commitments |
| BobbyAgentEconomyV2 | `0x009de59e0e7f4109fF9E89E744A4412082AD2aaF` | Native protocol economy |
| BobbyAdversarialBounties | `0x73fD6c77ff0403Ea071e8721c76f88cE34ac9968` | Adversarial rewards |
| HardnessRegistry | `0x15800F40b8988765AD3F46030B73bC8109A793f5` | Difficulty-weighted scoring |
| BobbyAgentRegistry | `0xB3137D7afE26fbdBcAA95573C7A20be896efde93` | Staked agent identities |
| BobbyIntentEscrow | `0x5D9d534419421B7Edfe9Bb509E4c48512256BC97` | Separate attested-intent ledger |

Deployment block: `50275770`. Production Safe: `0x8BE60853F27b944e11486285d95c3e06596553b4`.

## Self-custodial Base swap rail

`GET /api/base-swap` returns quotes only. A write request requires wallet-session proof, origin and rate-limit checks, an exact operations switch, eligibility gates and the user's own wallet signature. Bobby never signs for the user.

Confirmed receipts are stored in a chain-ordered ledger. FIFO matching rebuilds each wallet-and-pair history from canonical block and transaction order, including receipts confirmed out of order. Portfolio PnL is wallet-scoped and reads the complete paginated ledger.

Tokenized-stock calldata is live under a canary: an eligibility attestation, a country gate, an allow-listed wallet and a per-ticket cap must all pass before the server builds anything. Quotes stay public and read-only either way.

## Read the conviction oracle

```solidity
interface IBobbyOracle {
    function getConviction(string memory symbol) external view returns (
        uint8 direction,
        uint8 conviction,
        uint96 entryPrice,
        bool isActive
    );
}

IBobbyOracle oracle = IBobbyOracle(0x27f51D711171c830dd796D4B03914a8C6c46D75e);
```

## Links

- Product: https://bobbyprotocol.xyz
- App: https://bobbyprotocol.xyz/app
- Docs: https://bobbyprotocol.xyz/protocol/docs
- Live desk: https://bobbyprotocol.xyz/agentic-world/bobby
- MCP: https://bobbyprotocol.xyz/api/mcp-bobby
- Base TrackRecord: https://basescan.org/address/0x822DB0DbbCAB398e610fcBA86DA9BB92d2493321
- GitHub: https://github.com/anthonysurfermx/Bobby-Agent-Trader