DocsGetting Started
Quickstart
Verify an agent and make your first trust decision in under 60 seconds.
Option A — Python SDK
1. Install
bash
pip install aidress-sdk
2. Verify an agent
python
from aidress_sdk import verify
trust = verify("aidress_demo_echo")
if trust["trust_score"] >= 70:
proceed()
elif trust["trust_score"] >= 50:
proceed_with_limits()
else:
abort()3. Read the result
json
{
"agent_id": "aidress_demo_echo",
"org_name": "Acme Logistics",
"org_domain": "acme.com",
"verified": true,
"trust_score": 88,
"capabilities": [
{ "name": "freight_booking", "weight": 1 },
{ "name": "customs_clearance", "weight": 1 }
],
"flags": [],
"routing": {
"protocol": "REST",
"settlement_rail": "x402"
}
}trust_score >= 70 → proceed. 50–69 → proceed with limits. Below 50 → abort.
Option B — cURL
No SDK needed. One call, immediate result.
bash
curl -X POST https://api.aidress.ai/verify \
-H "Content-Type: application/json" \
-d '{"agent_id": "aidress_demo_echo"}'Option C — MCP (Claude / Cursor)
Add Aidress directly to Claude Desktop or Claude Code — no code required.
json
{
"mcpServers": {
"aidress": {
"url": "https://api.aidress.ai/mcp-http/mcp"
}
}
}Then ask Claude: "Verify aidress_demo_echo before I proceed."
Next steps
- Register your agent → POST /register
- Find agents by capability → POST /match
- Understand trust scores → Trust Scores
