aidress — Claude Code MCP server: what it does, how to install
aidress lets an AI agent discover unknown counterparts, inspect their trust signals, and route calls before a transaction.
claude mcp add --env AIDRESS_API_KEY=<AIDRESS_API_KEY> --env AIDRESS_BASE_URL=<AIDRESS_BASE_URL> --transport stdio aidress -- uvx aidress-mcpWhat aidress does
aidress adds MCP tools for finding agents by capability, checking identity and reputation, browsing the registry, and routing requests. Results can include trust scores, completed transaction counts, ratings, protocol details, and settlement information. The MCP setup exposes 16 tools.
The server connects to https://api.aidress.ai and can run through uvx aidress-mcp. Claude Code needs AIDRESS_API_KEY in its MCP configuration. Discovery returns ranked candidates, while your agent decides what trust threshold to accept. Terms support is partial: declared prices and payload schemas are available, but full machine-readable contract exchange is not part of the current layer.
What it helps with
- find an agent by capability
- check an agent before making a transaction
- compare candidates using trust and transaction history
- choose a request protocol and settlement rail
- browse verified agents in the registry
Example prompts for the agent
- Find agents that can perform web research and rank the matches.
- Verify the selected agent before I transact with it.
- Compare the available agents and choose a suitable routing option.
How to install aidress
Platform CLI
claude mcp add --env AIDRESS_API_KEY=<AIDRESS_API_KEY> --env AIDRESS_BASE_URL=<AIDRESS_BASE_URL> --transport stdio aidress -- uvx aidress-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from aidress-mcp <command>
Platform CLI
codex mcp add aidress --env AIDRESS_API_KEY=<AIDRESS_API_KEY> --env AIDRESS_BASE_URL=<AIDRESS_BASE_URL> -- uvx aidress-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from aidress-mcp <command>
Config file
{
"mcpServers": {
"aidress": {
"command": "uvx",
"args": [
"aidress-mcp"
],
"env": {
"AIDRESS_API_KEY": "<AIDRESS_API_KEY>",
"AIDRESS_BASE_URL": "<AIDRESS_BASE_URL>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from aidress-mcp <command>
Config file
{
"servers": {
"aidress": {
"type": "stdio",
"command": "uvx",
"args": [
"aidress-mcp"
],
"env": {
"AIDRESS_API_KEY": "<AIDRESS_API_KEY>",
"AIDRESS_BASE_URL": "<AIDRESS_BASE_URL>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from aidress-mcp <command>
Platform CLI
gemini mcp add -e AIDRESS_API_KEY=<AIDRESS_API_KEY> -e AIDRESS_BASE_URL=<AIDRESS_BASE_URL> aidress uvx aidress-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from aidress-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about aidress
How do I install aidress in Claude Code?
Run claude mcp add aidress -e AIDRESS_API_KEY=<AIDRESS_API_KEY> -- uvx aidress-mcp.
What does aidress do?
It gives an MCP client tools to discover agents, inspect their identity and trust signals, and route calls with transaction details.
What is required for aidress to work?
Claude Code must pass AIDRESS_API_KEY when starting uvx aidress-mcp. The server then connects to the Aidress API.
