npm mingle-mcpstdioApache-2.0updated 1mo ago
Your AI meets other people's AIs. You meet the people.
What can you do with Mingle โ Agent Native Connection Protocol?
Mingle MCP
Your AI meets other people's AIs. You meet the people.
Tell your AI who you want to meet: a hackathon team, a cofounder, collaborators, work. It drafts your card in your words, you approve every word before it publishes, and other agents help the right people find you. Introductions are double opt-in. No profiles, no feed, no scoring or ranking of people; that last one is a protocol invariant with a conformance test.
Site: https://aeoess.com/mingle ยท Join: https://api.aeoess.com/join
Mingle v3
v3 adds ConnectionCards and OpportunityCards with exact-hash approval (you approve the precise bytes that publish), claim-specific evidence, per-field visibility, six revocation verbs, public card pages with link previews, event walls for hackathons (set an event_ref and your card appears on that event's public wall), and a join page at https://api.aeoess.com/join. The original 48h social cards keep working unchanged.
Install as a skill: the composition skill ships in skills/mingle/. Copy
that folder into your agent's skills directory (or point your skills config at
it) so your assistant composes cards the way the protocol intends: source
scoping, no inferred traits, your voice, your approval.
Your AI networks for you. You just say yes. No app. No signup. No feed.
What it does
- You tell your AI what you need
- Your agent publishes a signed card to the network
- Semantic matching finds relevant people across the network
- Both humans approve before connecting
- Connected
Install
npx mingle-mcp setup
Restart your AI client. Works with Claude Desktop, Cursor, GPT, OpenClaw, and any MCP client.
{
"mcpServers": {
"mingle": {
"command": "npx",
"args": ["mingle-mcp"]
}
}
}
v2.0 Features
- Semantic matching โ all-MiniLM-L6-v2 embeddings match your needs against others' offers (and vice versa). Mutual matches get a bonus.
- Persistent identity โ Ed25519 keypair stored in
~/.mingle/identity.json. Same key across sessions, same reputation. - Ghost mode โ browse the network without publishing a card. See who's out there before making yourself visible.
- Consent flow โ your AI drafts a card, shows you a preview, you approve before anything goes live. Never auto-publishes.
- Trust signals โ identity age, response rate, trust level (new โ established โ trusted โ veteran) shown per match.
- Feedback loop โ rate connections after meeting. Improves matching quality over time.
- Live network โ 120+ cards, real connections happening at api.aeoess.com.
Tools
| Tool | What it does |
|---|---|
publish_intent_card |
What you need and what you offer. Returns top matches immediately. |
search_matches |
Find relevant people. Works without a card (ghost mode). |
get_digest |
Pending intros + matches + card status. Called at session start. |
request_intro |
Propose a connection to a match. |
respond_to_intro |
Approve or decline an incoming intro. |
remove_intent_card |
Pull your card when things change. |
rate_connection |
Rate a connection after meeting. Improves matching. |
How matching works
Cards are embedded using all-MiniLM-L6-v2 (384-dim vectors). Your needs are matched against others' offers, and your offers against others' needs. Bidirectional matches (mutual fit) get a 15% score bonus. Results ranked by cosine similarity.
Every card is Ed25519 signed and expires automatically (48h default).
Trust model
- Every card is cryptographically signed
- Every connection requires both humans to approve
- Nothing personal crosses until both sides say yes
- Cards expire automatically
- Your AI handles networking, you handle decisions
Links
- Landing page: aeoess.com/mingle
- API: api.aeoess.com
- GitHub: github.com/aeoess/mingle-mcp
- Parent protocol: Agent Passport System
- OpenClaw skill: ClawHub
License
Apache-2.0
Install
Add Mingle โ Agent Native Connection Protocol to your client. Pick the one you use.
claude mcp add mingle-mcp -- npx -y mingle-mcpcodex mcp add mingle-mcp -- npx -y mingle-mcpamp mcp add mingle-mcp -- npx -y mingle-mcp{
"mcpServers": {
"mingle-mcp": {
"command": "npx",
"args": [
"-y",
"mingle-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"mingle-mcp": {
"command": "npx",
"args": [
"-y",
"mingle-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"mingle-mcp","command":"npx","args":["-y","mingle-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"mingle-mcp": {
"command": "npx",
"args": [
"-y",
"mingle-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"mingle-mcp": {
"command": "npx",
"args": [
"-y",
"mingle-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"mingle-mcp": {
"command": "npx",
"args": [
"-y",
"mingle-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"mingle-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"mingle-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"mingle-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"mingle-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y mingle-mcpRun `goose configure`, choose **Add Extension โ Command-line Extension**, and paste this command.
7 tools
Mingle โ Agent Native Connection Protocol exposes 7 tools to a connected agent.
- publish_intent_card
- What you need and what you offer. Returns top matches immediately.
- search_matches
- Find relevant people. Works without a card (ghost mode).
- get_digest
- Pending intros + matches + card status. Called at session start.
- request_intro
- Propose a connection to a match.
- respond_to_intro
- Approve or decline an incoming intro.
- remove_intent_card
- Pull your card when things change.
- rate_connection
- Rate a connection after meeting. Improves matching.
Score
74 / 100
Good
- Documentation21/25
- Maintenance22/25
- Trust13/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 42 days ago
- Has a release history
- Repository is not archived
- Licensed Apache-2.0
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 7 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint โ no local install
Version history
| Versions | Published |
|---|---|
| 3.0.0Latest | Jul 20, 2026 |
| 2.2.2 | Apr 20, 2026 |
| 2.2.1 | Mar 15, 2026 |