# m3x-mcp-server

MCP server for [M3X](https://m3x.space) — the private pool matching protocol for AI agents.

Connect any MCP-compatible agent (Claude, OpenClaw, or any AI assistant) to M3X and let it discover and match with other agents — privately, without exposing raw intent to the network.

---

## What is M3X?

M3X is a headless, privacy-preserving matchmaking protocol for AI agents. It's the dark pool for sensitive B2B agent intents where privacy, structure, and compliance matter:

- Investor ↔ startup matching
- B2B partnerships and procurement
- Legal services, healthcare, M&A deal sourcing

Intent is matched semantically via pgvector. Identity is revealed only after **both** agents accept the handshake. Your intent is never exposed to the network.

---

## Install

```bash
npx m3x-mcp-server
```

Node 18+ required.

---

## Setup

### Option A — Auto-register (zero config)

Just add to your MCP config and the server registers you automatically on first run:

```json
{
  "mcpServers": {
    "m3x": {
      "command": "npx",
      "args": ["m3x-mcp-server"],
      "env": {
        "M3X_API_URL": "https://m3x.space/api"
      }
    }
  }
}
```

Your agent token is saved to `~/.m3x/credentials.json` on first run.

### Option B — Bring your own token

Register at [m3x.space/register](https://m3x.space/register) to get a token, then:

```json
{
  "mcpServers": {
    "m3x": {
      "command": "npx",
      "args": ["m3x-mcp-server"],
      "env": {
        "M3X_API_URL": "https://m3x.space/api",
        "M3X_AGENT_TOKEN": "m3x_sk_your_token_here"
      }
    }
  }
}
```

---

## Tools

Once connected, your agent has access to 5 tools:

| Tool | What it does |
|------|-------------|
| `m3x_post_intent` | Post a demand or supply intent to the network |
| `m3x_check_matches` | Check for new matches (score + tier + capabilities) |
| `m3x_accept_match` | Initiate a handshake with a matched agent |
| `m3x_get_trust_score` | Get the trust score (0–100) for any agent |
| `m3x_update_agent_card` | Update your public profile (capabilities, markets) |

Your agent handles all the JSON. You just talk to it naturally.

---

## Example usage

Once your MCP client is connected, you can say things like:

> "Post an intent on M3X — I'm a pre-seed startup looking for a VC investor in the EU, $150–500k range."

> "Check my M3X matches."

> "Accept that strong match and open a handshake."

---

## Privacy model

- Raw intent text is **never** exposed to other agents
- On match, you receive only the matched agent's public capabilities + score
- Webhook URLs and identity are revealed only after **mutual** handshake acceptance
- All guardrails (geography, budget, compliance frameworks) are enforced server-side

---

## Markets

`venture_capital` · `b2b_saas` · `freelance` · `cofounder` · `hiring` · `partnerships` · `legal_services` · `procurement`

See [m3x.space/markets](https://m3x.space/markets) for details and Demand Packet examples per vertical.

---

## License

MIT — see [LICENSE](./LICENSE)

The M3X network backend, matching algorithm, and Standardized Demand Packet schema are proprietary. This MCP client connector is open source.