MCP Server Overview

┌─────────────────────────────────────────────────────────────┐
│                     AI Agent (Claude)                        │
└────────────────────────┬────────────────────────────────────┘
                         │ MCP Protocol (stdio/HTTP)
┌────────────────────────▼────────────────────────────────────┐
│                  RelayCore MCP Server                        │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ x402 Payment │  │ Cronos RPC   │  │ Crypto.com   │      │
│  │ Tools (3)    │  │ Tools (10+)  │  │ Bridge (2)   │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ Agent Mgmt   │  │ Service Disc │  │ Session/ACPS │      │
│  │ Tools (7)    │  │ Tools (9)    │  │ Tools (7)    │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ RWA State    │  │ Trading/Perp │  │ Analytics    │      │
│  │ Tools (11)   │  │ Tools (9)    │  │ Tools (8)    │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└────────────────────────┬────────────────────────────────────┘
                         │
        ┌────────────────┼────────────────┐
        │                │                │
┌───────▼──────┐  ┌──────▼──────┐  ┌─────▼──────┐
│ Facilitator  │  │ Cronos RPC  │  │ Supabase   │
│ SDK          │  │ (Testnet)   │  │ Database   │
└──────────────┘  └─────────────┘  └────────────┘

Agent: "Get a quote for BTC-USD long 10x with $1000"
MCP: Calls x402_get_quote_with_payment
  → Receives 402 from backend
  → Generates EIP-3009 signature
  → Settles via Facilitator
  → Retries with payment ID
  → Returns quote
Agent: Receives quote data instantly

// Agent calls MCP tool
register_agent({
  name: "PerpAI Quote Agent",
  category: "trading",
  endpoint: "https://api.example.com",
  capabilities: ["quote_aggregation", "dex_routing"]
})

// MCP server:
// 1. Mints agent NFT on IdentityRegistry contract
// 2. Stores metadata in Supabase
// 3. Returns agent ID and transaction hash

1. Provider registers service with price (e.g., 0.01 USDC per call)
2. Agent discovers service via search_services
3. Agent calls invoke_service
4. MCP handles x402 payment automatically
5. Service executes and returns result
6. Reputation updates based on outcome

1. create_session({ maxSpend: "100.00", duration: 86400 })
   → Returns 402 for deposit
2. Agent pays deposit via x402
3. Session activates with $100 budget
4. Agent makes 100 requests at $1 each
   → Each request deducts from session.released
   → No 402 responses, instant execution
5. Session expires, remaining balance refunded

1. rwa_create({ rwaId: "property_123", metadata: {...} })
   → State: "created"
2. rwa_transition({ rwaId: "property_123", toState: "verified", ... })
   → Receives 402, agent pays
   → State: "verified"
3. Service executes verification
4. rwa_submit_proof({ rwaId: "property_123", proof: {...} })
   → SLA verified, payment released
   → State: "settled"

get_quote({ pair: "BTC-USD", side: "long", leverage: 10, sizeUsd: 1000 })

Returns:
{
  bestVenue: "VVS Finance",
  entryPrice: 42500.50,
  liquidationPrice: 38250.45,
  fundingRate: 0.0001,
  sources: [
    { venue: "VVS Finance", price: 42500.50, liquidity: "high" },
    { venue: "Moonlander", price: 42510.20, liquidity: "medium" },
    { venue: "Delphi", price: 42505.00, liquidity: "low" }
  ]
}

{
  "mcpServers": {
    "relay-core": {
      "command": "node",
      "args": ["/absolute/path/to/relaycore/mcp-server/dist/index.js"],
      "env": {
        "RELAY_CORE_API_URL": "http://localhost:4000",
        "CRONOS_RPC_URL": "https://evm-t3.cronos.org",
        "WALLET_PRIVATE_KEY": "0x...",
        "X402_AUTO_PAY": "true"
      }
    }
  }
}

User: "Find a trading agent with reputation above 90"

Claude uses MCP:
1. search_agents({ category: "trading", minReputation: 90 })
   → Returns: PerpAI Quote Agent (score: 95)

2. get_agent({ agentId: "agent_123" })
   → Returns: endpoint, pricing, capabilities

3. create_session({ maxSpend: "50.00", duration: 3600 })
   → Receives 402, pays deposit

4. invoke_service({ serviceId: "agent_123", input: {...} })
   → Deducts from session, executes instantly

Result: Agent hired and executed within session budget

User: "Verify property asset property_123"

Claude uses MCP:
1. rwa_get_state({ rwaId: "property_123" })
   → Current state: "pending"

2. rwa_transition({ 
     rwaId: "property_123", 
     toState: "verified",
     agentAddress: "0x...",
     agentRole: "verifier"
   })
   → Receives 402, pays escrow

3. [Off-chain: Verification service executes]

4. rwa_submit_proof({ 
     rwaId: "property_123", 
     proof: { latency: 120, fields: {...} }
   })
   → SLA verified (latency < 300s)
   → Payment released to verifier
   → State: "settled"

Result: RWA verified with provable SLA compliance

User: "Get the best price for BTC-USD long 10x with $1000"

Claude uses MCP:
1. x402_get_quote_with_payment({
     pair: "BTC-USD",
     side: "long",
     leverage: 10,
     sizeUsd: 1000,
     autoPay: true
   })
   → Receives 402 from backend
   → Auto-pays via Facilitator
   → Retries with payment ID
   → Returns aggregated quote

Result: Best price from 6 DEX venues with automatic payment

// Before execution
const task = await createTaskArtifact({
  tool_name: "x402_pay",
  inputs: { recipient, amountUsdc, resourceUrl }
});

// After success
await settleTaskArtifact(task.task_id, { result: txHash });

// After failure
await failTaskArtifact(task.task_id, { 
  code: "INSUFFICIENT_BALANCE", 
  message: "Not enough USDC" 
});