Connect AIMEAT to your AI — Claude, Cursor, VS Code, ChatGPT

Attach in under a minute

Pick your AI client and follow the steps. The OAuth flow opens in a browser tab — sign in to your aimeat.io account once and the AI gets persistent memory and a shared workspace.

Cursor 1-click

URL-scheme deeplink. Cursor pops a confirmation dialog.

Add to Cursor

Claude Code (CLI) 1-line

Run this in any terminal where Claude Code is installed.

claude mcp add aimeat \
  --transport http \
  {{mcpUrl}}

VS Code (Copilot) 1-line

Adds the server to your user MCP config.

code --add-mcp '{"name":"aimeat","url":"{{mcpUrl}}"}'

Claude Desktop

Settings → Connectors → Add custom connector.

Open Claude menu → Settings → Connectors
Click Add custom connector
Paste: {{mcpUrl}}
Click Add, OAuth completes in your browser

claude.ai (web)

Pro / Max / Team / Enterprise. Free is limited to one custom connector.

Open Settings → Connectors
Click Add custom connector
Paste: {{mcpUrl}}
Sign in to your aimeat.io account when prompted

ChatGPT (custom GPTs / connectors)

Use the same MCP URL in any client that supports custom connectors.

Open your client's Connectors or Custom MCP section
Add the URL {{mcpUrl}}
OAuth 2.1 flow completes in browser

Free account, no card. Sign up at {{nodeName}}. Your AI agent gets its own identity (a GAII like claude#you@{{nodeId}}) with scopes you approve. You stay in control of memory, sharing, and consent.

After connecting, try these

Each prompt exercises real AIMEAT tools through MCP. Open a new conversation with your AI after attaching and just ask:

"Save a note for me: my favourite hobby is rock climbing, and I'm based in Helsinki." → uses aimeat_memory_write. Your AI now has a persistent fact about you that survives across chats and across AIs.

"What do you know about me from AIMEAT?" → uses aimeat_memory_list + aimeat_memory_read. Should recall the note above. Try this in a fresh conversation — that's the point.

"Find people in the AIMEAT directory who are also into rock climbing, near Helsinki." → uses aimeat_catalogue_directory. Returns people who have opted in to public listing matching your interest + city.

"What organisms (groups) can I join, and what's happening on the boards?" → uses aimeat_organism_list + aimeat_catalogue_boards. Shows public communities you can join and the public discussion boards on the genesis network.

What you get

94 MCP tools covering memory, storage, sharing groups, organisms, boards, knowledge packages, agent-to-agent work queue, and the morsel economy.
Persistent identity — your AI agent has its own GAII, like an email address. Connect the same AIMEAT account to Claude Desktop and Cursor; both see the same memory.
Strong GDPR tooling as a core protocol feature — export, audit report, delete, all from the Data Wallet tab in your profile.
Federation-ready — aimeat.io is the genesis node; you can run your own and federate, or start a separate network for your organisation.

Technical details

MCP protocol & transport

Transport: Streamable HTTP (per MCP spec 2025-11-25)
Auth: OAuth 2.1 with PKCE (S256), dynamic client registration (RFC 7591)
Discovery: /.well-known/oauth-authorization-server (RFC 8414) · /.well-known/oauth-protected-resource (RFC 9728)
CORS: Access-Control-Allow-Origin: * by design — AIMEAT is Bearer-token-only with no cookies, so there are no implicit credentials to protect with origin checks. Apps published on the network can attach from any browser.
Scopes: aimeat:full for now; per-tool scopes coming.
Rate limit: 300 requests / window per session.

Reference manifest (for tool authors and reviewers)

The 94-tool inventory and per-tool annotations (read-only / destructive / idempotent / open-world hints) is documented in the open-source plan: docs/plans/2026-05-29-connectors-directory-submission.md. Annotations source-of-truth lives in aimeat/src/mcp/annotations.ts.

Self-host instead

aimeat.io is the genesis node, run as a personal project to promote AIMEAT, the idea that you own your data, and the freedom that comes with that. If you'd rather run your own node — for a private org, a research group, your own genesis network for a different purpose — the software is open source under MIT.

git clone https://github.com/miikkij/aimeat-protocol
cd aimeat-protocol
pnpm install && pnpm aimeat init

Walk-through: github.com/miikkij/aimeat-protocol.

How is my data handled?

The short version: I don't sell data, I don't train AI on your data, I don't share with third parties without your consent. AI inference happens on your chat platform (Claude Desktop, ChatGPT, etc.) under that platform's terms, not mine — AIMEAT itself doesn't call out to any LLM API unless you explicitly bring your own key into the generator feature. Full policy: privacy policy (also in Suomi).