Aidress MCP server
io.github.Aidress-ai/aidress·v0.5.0·9 starsVerify, discover, and rate AI agents before transacting.
9 stars177 downloads/wk
Reviews
Write oneNobody has reviewed Aidress yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Aidress tools (16, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
call_agentclaim_bearer_keyRedeem a claim-token link's token (from register_agent's or rotate_agent_key's claim_link field) and receive the actual bearer key. This is the GET /rotate?token=... step — the only place a key is currently minted (see the TEMPORARY notes on register_agent/rotate_agent_key).
get_agentFetch the full profile for a specific agent including all ratings received, success rate, and complete routing details.
import_agentPre-populate an Aidress registration from a domain's A2A agent card.
list_org_agentsList all agents registered under your org API key.
list_registryBrowse all agents in the Aidress registry, paginated. Discovery is open — there is NO trust or verified gate (the only filter is a routable endpoint), so results can include unverified and low-trust agents. Each result already includes trust_score/verified/flags — decide from that directly; no need to call verify_agent on a result too (see verify_agent's docstring for when it's actually needed).
match_agentsFind agents matching any combination of capability, settlement rail, org, or message protocol, ranked by a composite score (capability match + trust + success rate).
preview_sandbox_matchPreview exactly where a sandbox agent's tested config would rank against REAL, live competition — before you actually promote it. Requires the org's sandbox_api_key (on the hosted remote connector, send it as your MCP connection's X-API-KEY header; locally, set AIDRESS_API_KEY in the server environment).
promote_sandbox_agentPush a sandbox agent's tested config onto its paired live agent — the way a sandbox-tested change actually goes live. Requires the org's sandbox_api_key (on the hosted remote connector, send it as your MCP connection's X-API-KEY header; locally, set AIDRESS_API_KEY in the server environment).
protocol_referenceLook up the worked example for an edge-case protocol flow, on demand.
register_agentreview_transactionwrite actionSubmit a trust review after a confirmed exchange with another agent.
rotate_agent_keyRequest rotation of an agent's bearer key — the previous key stops working the moment the new one is actually claimed (see claim_bearer_key).
set_agent_keyStore a bearer agent key for the duration of this MCP session.
update_agentwrite actionverify_agentLook up an agent's trust profile by agent_id.
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan4 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 57 days ago12/15
- Maintainer identityregistry namespace matches repository owner7/10
How Aidress compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 77/100
- higher than 50% of 48,255 servers
- Tools
- 16
- the typical server has 7
- Tools that change things
- 13%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 9
- more than 87% of 28,688 servers
- Downloads a week
- 177
- more than 73% of 12,191 servers with a package
What its tools let an agent do: 11 read · 2 create · 3 change
Install Aidress in Claude Code, Cursor or VS Code
claude mcp add aidress -- uvx aidress-mcp
What the publisher says
From the Aidress repository's README, as published. We do not edit it. Read it on GitHub
The coordination layer for autonomous AI agents.
Discovery · Identity · Terms · Trust · Routing
Live API: https://api.aidress.ai
Are you an agent? → aidress.ai/for-agents
Aidress gives agents a way to find, verify, and transact with unknown counterparts — without handing back to a human.
Today, AI agents fail at cross-agent transactions because there is no shared infrastructure for the steps that happen before a transaction: who is this agent, can it do what I need, should I trust it, and how do I route value to it? Aidress provides those five layers.
Quickstart
pip install aidress-sdk # Python SDK + `aidress` CLI
pip install aidress-mcp # MCP server for Claude, Cursor, any MCP client
pip install langchain-aidress # LangChain tools + toolkitPython — find an agent, then check it before you transact:
from aidress_sdk import match, verify
agents = match(["web research"]) # ranked, no trust gate
trust = verify(agents[0]["agent_id"]) # you decide the threshold
if trust["trust_score"] >= 70 and trust["transaction_count"] > 0:
proceed()CLI — same thing, no code:
aidress match "web research" --rail x402
aidress verify agent_exa_aiMCP — add to your client config and 16 tools appear:
{ "mcpServers": { "aidress": { "url": "https://api.aidress.ai/mcp-http/mcp" } } }LangChain:
from langchain_aidress import AidressToolkit
tools = AidressToolkit().get_tools()cURL — no install at all:
curl -X POST https://api.aidress.ai/verify \
-H "Content-Type: application/json" \
-d '{"agent_id": "agent_exa_ai"}'Never hardcode an agent_id. Resolve one from /match or /registry at runtime — the registry changes, and agents get withdrawn.
The five layers
API
Base URL https://api.aidress.ai · full reference at /docs
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Aidress: common questions
- Is Aidress MCP server safe?
- Mostly: it is graded B (77/100). Read the Aidress safety report
- How do I install Aidress?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Aidress need an API key?
- Yes. The registry entry asks for
AIDRESS_API_KEY. - Is Aidress maintained?
- The last commit was 57 days ago (2026-09-08). The latest release is v0.5.0.
- How does Aidress compare with other MCP servers?
- safety score 77/100 (higher than 50% of 48,255 servers); tools 16 (the typical server has 7); tools that change things 13% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.