A2A Protocol Support

What is the Sertone control center? A single Docker container you run on your own machine — a laptop, a Raspberry Pi, a cloud server. It connects you to the Sertone Global Network. Through its built-in web console, you browse services, register your own, manage your wallet, and monitor your earnings. Installation takes minutes. It is completely free, forever.

#!/usr/bin/env python3
"""
My First A2A Agent — discovers and calls services on the Sertone network.
No SDK needed. Just HTTP requests.
"""
import requests

SERTONE = "https://localhost:3000"  # Your Sertone control center
SECRET  = "YOUR_CONSUMER_SECRET"    # From Settings > Security in your web console

# Step 1: Discover services
print("Discovering earthquake services...")
agents = requests.get(f"{SERTONE}/a2a/discover",
    params={"capability": "earthquake", "limit": 3},
    verify=False  # remove in production with proper TLS
).json()

for agent in agents["agents"]:
    print(f"  Found: {agent['name']} — ${agent['x_sertone']['price_per_call']}/call")

# Step 2: Read the agent card
uuid = agents["agents"][0]["x_sertone"]["uuid"]
card = requests.get(f"{SERTONE}/agent/{uuid}/card.json", verify=False).json()
print(f"\nAgent: {card['name']}")
print(f"Skills: {[s['name'] for s in card['skills']]}")

# Step 3: Call the service via A2A JSON-RPC
print(f"\nCalling {card['name']}...")
response = requests.post(f"{SERTONE}/a2a/message",
    headers={"X-Consumer-Secret": SECRET, "Content-Type": "application/json"},
    json={
        "jsonrpc": "2.0",
        "method": "message/send",
        "params": {
            "api_uuid": uuid,
            "content": '{"path":"/v1/earthquakes/recent","method":"GET","params":{"min_magnitude":5,"limit":5}}'
        },
        "id": 1
    },
    verify=False
).json()

# Step 4: Use the result
if "result" in response:
    data = response["result"]["output"]
    print(f"Status: {response['result']['status']}")
    if isinstance(data, dict) and "data" in data:
        for eq in data["data"][:5]:
            print(f"  M{eq.get('magnitude','?')} — {eq.get('place','?')}")
    print(f"\nSettlement: automatic, USDC")
else:
    print(f"Error: {response.get('error',{}).get('message','unknown')}")

$ python3 my_agent.py

Discovering earthquake services...
  Found: USGS Earthquake Catalog — $0.001/call

Agent: USGS Earthquake Catalog
Skills: ['Recent Earthquakes', 'Earthquake Search']

Calling USGS Earthquake Catalog...
Status: completed
  M5.2 — 120km SSW of Kodiak, Alaska
  M5.0 — Vanuatu
  M5.1 — South Sandwich Islands

Settlement: automatic, USDC

#!/usr/bin/env node
// My First A2A Agent — Node.js version
const SERTONE = 'https://localhost:3000';
const SECRET = 'YOUR_CONSUMER_SECRET';

async function main() {
  // Discover
  const agents = await fetch(`${SERTONE}/a2a/discover?capability=earthquake&limit=3`)
    .then(r => r.json());
  console.log(`Found ${agents.agents.length} service(s)`);

  // Call via A2A
  const uuid = agents.agents[0].x_sertone.uuid;
  const result = await fetch(`${SERTONE}/a2a/message`, {
    method: 'POST',
    headers: { 'X-Consumer-Secret': SECRET, 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      method: 'message/send',
      params: { api_uuid: uuid, content: '{"path":"/v1/earthquakes/recent","method":"GET"}' },
      id: 1,
    }),
  }).then(r => r.json());

  console.log('Result:', JSON.stringify(result.result?.output, null, 2));
}
main();

# Discover services
curl -sk "https://localhost:3000/a2a/discover?capability=earthquake&limit=3" | python3 -m json.tool

# Call a service directly
curl -sk -X POST "https://localhost:3000/a2a/message" \
  -H "X-Consumer-Secret: YOUR_CONSUMER_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "message/send",
    "params": {
      "api_uuid": "YOUR_SERVICE_UUID",
      "content": "{\"path\":\"/v1/earthquakes/recent\",\"method\":\"GET\"}"
    },
    "id": 1
  }' | python3 -m json.tool

Ask your Sertone to find all services with a given capability. Returns a list of agent cards matching your query.

Every registered service on Sertone auto-generates a standards-compliant A2A agent card. Fetch it to see full capabilities, supported methods, and authentication requirements.

Send a standard A2A message/send call. Your Sertone routes it through the network, settles the payment automatically, and returns the response.