For developers

33 MCP tools. One identity.

Integrate AMBER over MCP or REST, keyed by your agent's ERC-8004 identity. One HTTP call, one x402 signature, no separate billing account.

Quickstart

One HTTP call. Either protocol.

REST and MCP hit the same identity-keyed memory store. Pick REST for a quick curl, MCP for a tool-calling agent client — both settle through the same x402 flow.

curl · GET /memory/query
curl "https://amber-mcp.xyz/memory/query?identity=0x1a2b...&q=deploy config"

HTTP/1.1 402 Payment Required
www-authenticate: Payment realm="AMBER", scheme="x402-exact", network="eip155:196"
payment-required: eyJ4NDAyVmVyc2lvbiI6MiwicmVzb3VyY2Ui...
MCP · initialize → tools/list → tools/call
// 1. initialize
POST /mcp  { "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": { "protocolVersion": "2025-06-18", "capabilities": {},
              "clientInfo": { "name": "my-agent", "version": "1.0" } } }

// 2. tools/list — all 33 tools, memory_query, memory_write, ...
POST /mcp  { "jsonrpc": "2.0", "id": 2, "method": "tools/list" }

// 3. call a tool
POST /mcp  { "jsonrpc": "2.0", "id": 3, "method": "tools/call",
  "params": { "name": "memory_query",
              "arguments": { "identity": "0x1a2b...", "q": "deploy config" } } }
GET /agent.json · ERC-8004
curl https://amber-mcp.xyz/agent.json

{
  "$schema": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "AMBER",
  "x402Support": true,
  "supportedSchemes": ["exact", "period"],
  "identity": {
    "erc8004Registry": "0x8004a169fb4a3325136eb29fa0ceb6d2e539a432",
    "chainId": 196
  },
  "services": [
    { "name": "MCP", "type": "A2MCP", "endpoint": "https://amber-mcp.xyz/mcp" },
    { "name": "REST", "type": "HTTP", "endpoint": "https://amber-mcp.xyz" }
  ]
}

REST vs MCP

Same identity, same ledger, two transports.

REST

Plain HTTP endpoints under amber-mcp.xyz. Good for a quick curl, a server-side integration, or any client that doesn't speak MCP.

MCP

A2MCP transport at /mcp (protocol 2025-06-18). All 33 tools listed via tools/list— the natural fit for an agent that calls tools directly.

MCP tools

Five categories, thirty-three tools.

33 MCP tools · protocol 2025-06-18

Memory core

12 tools

  • memory_write
  • memory_query
  • memory_bulk_write
  • memory_list
  • memory_get
  • memory_delete
  • memory_session_context
  • memory_consolidate
  • memory_diff
  • memory_pin
  • memory_related
  • memory_template

Identity & reputation

4 tools

  • identity_stats
  • memory_whoami
  • memory_reputation_lookup
  • memory_verify_attestation

Portrait & provenance

4 tools

  • portrait_get
  • seal_generate
  • memory_share
  • memory_portability_pack

Vertical copilots

8 tools

  • finance_brief
  • lifestyle_remember
  • daily_brief
  • memory_goal_set
  • memory_habit_check
  • portfolio_snapshot
  • memory_analytics
  • memory_graph

Onboarding & ops

5 tools

  • memory_demo_pack
  • memory_seed_wallet
  • amber_onboarding
  • amber_judging_pack
  • amber_live_stats

Live references

The manifests, not the marketing.

agent.json (ERC-8004).well-known/x402API docsOKX.AI tutorial