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 -->