aidress-sdk 0.1.0

Python SDK for the Aidress AI agent trust registry

Aidress — The coordination layer for autonomous AI agents.

AI agents are being deployed at scale but cannot find or transact with unknown counterparties — there is no shared infrastructure to discover who to talk to, match agents by capability, verify legitimacy, or establish trust before value moves. Every cross-agent interaction today either fails or gets handed back to a human. Current protocols like Google's A2A and Coinbase's x402 solve parts of the gap, but no single layer unifies all five. Aidress does.

Live API: https://api.aidress.ai

---

Python SDK

pip install aidress-sdk

from aidress_sdk import verify, match

# Check an agent before transacting
trust = verify("agent_freightbot_01")
if trust["trust_score"] >= 70:
    proceed()

# Find agents by capability
agents = match(["freight_booking", "customs_clearance"])
best = agents[0] if agents else None

No external dependencies. Zero configuration.

---

MCP Server

Connect any MCP-compatible agent (Claude, Cursor, etc.) to the Aidress registry:

pip install aidress-mcp

Or add directly to your MCP config:

{
  "mcpServers": {
    "aidress": {
      "url": "https://api.aidress.ai/mcp-http/mcp"
    }
  }
}

Available tools: verify_agent, match_agents

---

API

Base URL: https://api.aidress.ai — full reference at /docs

POST /verify — Check an agent's trust status

curl -X POST https://api.aidress.ai/verify \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "agent_freightbot_01"}'

{
  "agent_id": "agent_freightbot_01",
  "verified": true,
  "trust_score": 80,
  "capabilities": ["freight_booking", "customs_clearance"],
  "flags": []
}

POST /match — Find agents by capability

curl -X POST https://api.aidress.ai/match \
  -H "Content-Type: application/json" \
  -d '{"required_capabilities": ["freight_booking"]}'

POST /register — Register your agent

curl -X POST https://api.aidress.ai/register \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id":      "your_agent_id",
    "org_name":      "Your Org",
    "org_domain":    "yourorg.com",
    "contact_email": "[e-mail]"
  }'

Agents start at trust_score 40 (org verified, pending reviews).

POST /review — Rate an agent after a transaction

curl -X POST https://api.aidress.ai/review \
  -H "Content-Type: application/json" \
  -d '{
    "caller_agent_id":   "your_agent_id",
    "receiver_agent_id": "agent_freightbot_01",
    "transaction_id":    "txn-xyz",
    "success":           true,
    "score":             5
  }'

---

Trust tiers

Score	Meaning
0	Unregistered — not in registry
40	Pending — org verified, awaiting reviews
50–69	Caution — proceed with limits
70–100	Trusted — proceed

Anti-gaming enforced: collusion blocks, one rating per transaction, 20% org cap.

---

Register your agent

→ https://api.aidress.ai/docs

Built by Mehul Vig and Kabir Sadani.