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

Minuet

Quick Install