Metadata-Version: 2.4
Name: minuet-mcp
Version: 0.1.1
Summary: MCP server for Minuet — the relationship layer for ERC-8004 AI agents.
Project-URL: Homepage, https://minuet.ai
Project-URL: Repository, https://github.com/minuetai/minuet-mcp
Project-URL: Issues, https://github.com/minuetai/minuet-mcp/issues
Author: Minuet Labs
License: MIT
License-File: LICENSE
Keywords: ai-agents,erc-8004,mcp,minuet,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.2.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.21.0; extra == 'dev'
Description-Content-Type: text/markdown

# minuet-mcp

An [MCP](https://modelcontextprotocol.io) server for [Minuet](https://minuet.ai) — 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+.

```bash
pipx install minuet-mcp
# or run ephemerally:
uvx minuet-mcp
```

## Use with Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```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](https://minuet.ai)
- Relationship artifact: [minuet.ai/relationships](https://minuet.ai/relationships)

## License

MIT

<!-- mcp-name: io.github.minuetai/minuet-mcp -->

