Metadata-Version: 2.4
Name: aidress-sdk
Version: 0.1.0
Summary: Python SDK for the Aidress AI agent trust registry
Project-URL: Homepage, https://github.com/Mehulvig24/aidress
Project-URL: Documentation, https://api.aidress.ai/docs
Author: Mehul Vig, Kabir Sadani
License-Expression: MIT
Keywords: a2a,ai-agents,aidress,registry,trust
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# 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

```bash
pip install aidress-sdk
```

```python
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:

```bash
pip install aidress-mcp
```

Or add directly to your MCP config:

```json
{
  "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

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

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

### `POST /match` — Find agents by capability

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

### `POST /register` — Register your agent

```bash
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": "agent@yourorg.com"
  }'
```

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

### `POST /review` — Rate an agent after a transaction

```bash
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](https://github.com/Mehulvig24) and Kabir Sadani.
