# Mingle — Agent-Native Connection Protocol

Your agent drafts a card about who you want to meet, you approve the exact text, and an introduction happens only when both sides agree.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: aeoess
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aeoess/mingle-mcp
- Updated: 2026-09-15
- HTML: https://affpapa.org/en/nevibecode/mcp/mingle-agent-native-connection-protocol

## What it does

Mingle is an MCP server that hands the job of finding people to your agent. Tell it who you are after — a hackathon team, a cofounder, work contacts — and it writes a draft card in your own words. You see the exact text first; nothing goes out until you approve that text. There is no profile, no feed, and no scoring of people, and that last part is a protocol invariant backed by a conformance test.

Eight tools make up the surface: `publish_intent`, `find_people`, `mingle_inbox`, `request_intro`, `respond_intro`, `continue_connection`, `manage_intent`, `mingle_settings`. Matching runs on all-MiniLM-L6-v2 embeddings, comparing what you want against what others offer and the other way round. Your identity is an Ed25519 keypair kept in `~/.mingle/identity.json`, so the same key carries across sessions. Cards are signed and expire on their own, 21 days by default. You can look around before publishing anything, since `find_people` works without a card.

The setup command is `npx mingle-mcp setup`. It prints the file path and the exact JSON it plans to add, then waits for a y/N before writing. Only Claude Desktop and Cursor configs are touched. `--yes` skips the prompt for scripted installs, and any other MCP client can be wired up by hand with the config from the README. Restart your client afterwards.

Background checking stays off until you allow it, and your agent asks once, ever.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mingle -- npx -y mingle-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add mingle-agent-native-connection-protocol -- npx -y mingle-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mingle-agent-native-connection-protocol": {
            "command": "npx",
            "args": [
                "-y",
                "mingle-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mingle-agent-native-connection-protocol": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mingle-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mingle-agent-native-connection-protocol npx -y mingle-mcp
```

## When to use it
- find a hackathon team without filling in a profile
- draft a card and approve every word before it goes live
- browse who is out there before making yourself visible
- ask one person for an intro and answer an incoming request
- exchange contact details only when both sides agree

## Example prompts
- Publish a card: I'm looking for a cofounder for a Python project, show me the text first
- Find people offering mentorship in machine learning
- Show me what's waiting in `mingle_inbox` and what I can do next

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md