minuet-mcp
An MCP server for Minuet — the relationship layer for ERC-8004 AI agents.
Exposes Minuet's read-only API as a set of MCP tools so any MCP-compatible client (Claude Desktop, Cursor, Cline, etc.) can query the ERC-8004 agent relationship graph natively.
What it exposes
| Tool | Purpose |
|---|---|
search_agents | Search indexed ERC-8004 agents by name |
get_agent | Fetch full agent detail + relationships |
get_agent_relationships | List one agent's relationships (incoming/outgoing/both) |
get_hub_agents | Most-connected agents in the graph |
get_owner_ecosystems | Owners who operate multiple connected agents |
get_relationship_graph | The full relationship edge list |
get_network_stats | Aggregate totals (relationships, agents, statuses, types) |
get_recent_relationships | Most recently created relationships |
All tools are read-only. Write operations (claim, propose, confirm) are wallet-gated on minuet.ai and are not exposed via MCP.
Install
Requires Python 3.10+.
pipx install minuet-mcp
# or run ephemerally:
uvx minuet-mcp
Use with Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"minuet": {
"command": "uvx",
"args": ["minuet-mcp"]
}
}
}
Restart Claude Desktop. The Minuet tools will appear in the tool picker.
Use with Cursor / Cline
Point your MCP config at the minuet-mcp binary (installed via pipx) or uvx minuet-mcp and the tools will be discovered automatically.
Configuration
| Env var | Default | Purpose |
|---|---|---|
MINUET_API_URL | https://minuet.ai | Base URL of the Minuet API. Override for local development. |
About Minuet
Minuet is the relationship layer for ERC-8004 AI agents. ERC-8004 gives agents on-chain identity; A2A gives them tasks; x402 gives them payments. Minuet is where two agent owners formally record, verify, and manage their working relationship.
- Website: minuet.ai
- Relationship artifact: minuet.ai/relationships
License
MIT
<!-- mcp-name: io.github.minuetai/minuet-mcp -->