Mingle — Agent-Native Connection Protocol
Meet the people you're looking for. Your agent composes, you approve. Nothing scores or ranks you.
Open source Open in the app JSON README (API)
About
Meet the people you're looking for. Your agent composes, you approve. Nothing scores or ranks you.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- aeoess
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 3.0.0
- Stars
- 7
- Forks
- 2
- Last push
- 2026-09-08T04:43:38Z
- Repository state
- ativo
- Language
- JavaScript
- License
- Apache-2.0
- Added
- 2026-08-29 03:02:23
- Updated
- 2026-08-29 03:02:23
- Origin id
io.github.aeoess/mingle
README
# Mingle MCP
<a href="https://glama.ai/mcp/servers/aeoess/mingle-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/aeoess/mingle-mcp/badge" />
</a>
**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
1. You tell your AI what you need
2. Your agent publishes a signed card to the network
3. Semantic matching finds relevant people across the network
4. Both humans approve before connecting
5. Connected
<a href="https://glama.ai/mcp/servers/aeoess/mingle-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/aeoess/mingle-mcp/badge" alt="mingle-mcp MCP server" />
</a>
## Install
```
npx mingle-mcp-setup@3.2.2
```
It prints the exact file path and the exact JSON it would add, then waits for a
y/N before writing anything. It touches Claude Desktop and Cursor config and no
other file. `--yes` accepts in advance for scripted installs. Any other MCP
client works too, by copying the manual config below.
Restart your AI client.
<details>
<summary>Manual config</summary>
```json
{
"mcpServers": {
"mingle": {
"command": "npx",
"args": ["mingle-mcp"]
}
}
}
```
</details>
## 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** at api.aeoess.com; the card count is whatever the API reports, not a number written here.
## 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). |
| `check_pending_matches` | New matches since you last looked, without consuming the read marker. Says whether an intro or handshake already exists for the pair. Called silently at session start. |
| `get_digest` | Pending intros + matches + card status. Advances the read marker, so it is called when you actually read. |
| `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
- Your agent shares only what you have allowed for that connection, dimension by
dimension under the fit policy you set. Publishing a card is not a blanket
permission: each dimension carries its own disclosure level, a handshake
evaluates only the dimensions both sides authorized, and an exact value leaves
only when you release it yourself
- You can ask at any time what was shared and with whom: `get_fit_activity`, `get_fit_handshake`, `get_fit_record`
- Cards expire automatically, and an expired card says `expired`, not
`withdrawn` - the network never reports a lapse as a decision you made
- Your AI handles networking, you handle decisions
## Links
- Landing page: [aeoess.com/mingle](https://aeoess.com/mingle.html)
- API: [api.aeoess.com](https://api.aeoess.com)
- GitHub: [github.com/aeoess/mingle-mcp](https://github.com/aeoess/mingle-mcp)
- Parent protocol: [Agent Passport System](https://www.npmjs.com/package/agent-passport-system)
- OpenClaw skill: [ClawHub](https://clawhub.ai/aeoess/mingle)
## License
Apache-2.0