@gemmein/mcp

@gemmein/mcp

The Gemmein MCP server — gives your coding agent the whole Gemmein contract as tools, straight in the editor.

Gemmein is the backend for web and mobile apps: sign-in, protected data, payments, AI tools and a dashboard to run your customers. This server is read-only: it never creates, edits, or deletes anything on the platform.

Setup

Claude Code:

claude mcp add gemmein -- npx -y @gemmein/mcp

Cursor / any MCP client (mcpServers config):

{ "gemmein": { "command": "npx", "args": ["-y", "@gemmein/mcp"] } }

Tools

• guide — call first: it opens with two doors — an idea with nothing built yet, or an app that already exists — and both reach the same fit assessment (FITS / FITS EXCEPT / DOESN'T FIT — the verdict an agent delivers before any install), then the full builder's guide (auth flow, the seven collection safety rules, record shapes, links, uploads, contention patterns, payments, credits, AI tools, relays, mobile).
• reference — the exact SDK API reference: every method, signature, return shape, error code.
• search_docs — targeted search over both documents.
• explain_rule — any safety rule's contract, what it's right for, and the mistakes to avoid (or a cheat-sheet of all seven).
• explain_error — what a GemmeinError code means and exactly what to do.
• explain_relay — how a relay is written: its trigger, the ten action verbs (write_record, grant_access, revoke_access, grant_credits, email_person, call_url, fulfil_product, refund_product, grant_plan, revoke_plan), templates, and the refusals the engine answers.
• validate_collection_name — catch a bad collection name at planning time (a bad name throws synchronously and can blank an app silently).
• reaffirm_template — the ready-to-edit CI harness that proves an app's boundaries on every deploy.
• check_integration — run those boundary checks live against your own app right now: anonymous access refused where it must be, cross-user isolation proven with throwaway dev test sessions, structured pass/fail back. Never pass a live secret key — sk_live is refused by design.

The companion SDK

Your app talks to Gemmein through @gemmein/sdk. This server teaches your agent to use it correctly.

MIT © Gemmein Limited