air-mcp-server

Model Context Protocol server for the Agent Identity Registry (AIR).

Drop into any MCP-aware LLM client (Claude Code, Cursor, Codex, etc.) and your agent can look up identities, trust scores, and W3C DID documents from the AIR registry — no SDK install required by the LLM client.

v0.1 — Read-only

Six tools, all read-only. Write operations (register, update) require an agent_secret whose handling crosses the LLM context, which is a sharper design decision that deserves its own release. See air/mcp-server-architecture-decision for the full reasoning.

Install

pip install air-mcp-server

Requires Python 3.10+.

Use with Claude Code

Add to your Claude Code MCP config (typically ~/.claude/mcp.json or project .mcp.json):

{
  "mcpServers": {
    "air": {
      "command": "air-mcp-server"
    }
  }
}

Or use python -m:

{
  "mcpServers": {
    "air": {
      "command": "python",
      "args": ["-m", "air_mcp"]
    }
  }
}

Then in any Claude Code session: "look up agent AIR-7F3K-M9JQ-X2PL in AIR" or "what's the trust score for DataProcessor-v3" and Claude will invoke the right tool.

Configure

Transports

stdio (default — used by Claude Code, Cursor, Codex):

air-mcp-server

Streamable-HTTP (for remote MCP clients):

air-mcp-server --transport streamable-http --port 8080

License

Apache 2.0.