About Minuet
Minuet is an MCP server for clients that need to explore the ERC-8004 AI agent relationship graph. It provides read-only queries for agents, relationships, and network statistics.
Key features
- 01Search agents by name
- 02Retrieve agent details and relationships
- 03Inspect incoming and outgoing relationships
- 04Find highly connected agents and owners
- 05View graph edges and network statistics
- 06List recently created relationships
Use cases
- 01Find an ERC-8004 agent by name
- 02Review an agent’s connections
- 03Identify owners with connected agents
- 04Inspect graph-wide relationship trends
MCP support
Exposes Minuet’s read-only API as MCP tools for compatible clients. Wallet-gated write operations are not available through MCP.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEminuet-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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.