MCP integration · Claude Code, Claude Desktop, and more

Plug your wedding
into Claude

Sposai speaks MCP — the same open protocol Claude Code and Claude Desktop use. Mint a token, paste a config, and drive your guest list, seating chart, and run sheet from the AI surface you already live in.

Why ship a wedding tool as an MCP server?

Because the AI you already trust — the one you use to draft emails and review code — should be allowed to help with the biggest project on your plate.

Use any AI surface

Claude Code today; Claude Desktop, ChatGPT with MCP, or your own scripts — anything that speaks the protocol. One token, every client.

Read and write — 37 tools

The exact catalogue the in-app Sposai chat uses. Query guests, update RSVPs, draft run sheets, move tables, fix data health. No read-only downgrade.

Confirm-on-write safety

Writes always preview first and wait for your explicit yes. Scoped tokens let you pick read-only or read-write. Revoke any token instantly from your dashboard.

For wedding planners

Managing 10 weddings? One token scopes to all of them.

When you mint a token, pick which weddings it can act on — every wedding you're a member of, a single client, or any subset. Add a new wedding to your roster later and it automatically inherits your token's access. Switch weddings mid-conversation (coming soon) — until then, mint a per-wedding token if you need to focus.

Mint a multi-wedding token

Three steps to connect

About 90 seconds, end-to-end. You'll need Claude Code or another MCP-compatible client already installed.

01

Click Add to Claude Code

Visit /dashboard/settings/integrations in Sposai and click Add to Claude Code. We'll mint a fresh token named after your device — no form, no scope picker, no expiration dropdown. (Want fine-grained control? Use the Advanced disclosure to mint a raw token instead.)

02

Paste the command in your terminal

The connect modal shows a single line you copy into your shell. No .mcp.json, no local checkout, no DATABASE_URL — Sposai hosts the MCP endpoint and you authenticate with the bearer token. Looks like this, with your real token in place of the placeholder:

claude mcp add --transport http sposai https://sposai.com/api/mcp --header 'Authorization: Bearer tok_paste_your_token_here'
03

Restart and ask

Restart Claude Code. Type /mcp — you should see sposai connected with 37 tools. Then ask Claude: "How many guests have RSVP'd?" — it calls queryGuests and answers from your real data.

On Claude Desktop? Skip the paste.

Claude Desktop's native Add Integration UI speaks OAuth 2.1 with PKCE. Pick Sposai from the connectors list, sign in once, click Allow, and you're connected — no command to copy, no token to paste. The Sposai server handles consent, scope, and revocation through standard OAuth endpoints (RFC 7591 DCR and CIMD client_ids both supported).

Once connected, your Sposai dashboard's Devices panel shows the Claude Desktop entry with an OAuth badge and one-click revoke.

Common questions

Is this safe?

+
Every write tool follows the same confirm-on-write pattern as the in-app chat — Claude previews the change and waits for your explicit yes before mutating. Tokens are scoped to the weddings you pick, hashed at rest with scrypt, and you can choose read-only if you'd rather hand a third-party script a zero-blast-radius credential. Revoke from your dashboard and it stops working on the next call.

What can I ask?

+
Anything the in-app chat can do. A sampler:
  • "Move Maria and her plus-one to table 4."
  • "Who hasn't RSVP'd yet?"
  • "Draft a follow-up email for the florist."
  • "What payments are due next month?"
  • "Run a data-health check and fix what you can."

Does it cost extra?

+
No. The MCP integration is included with every Sposai plan. AI usage from MCP counts against the same monthly budget as the in-app chat — there's no separate billing surface.

What about other AI clients?

+
We've verified the integration end-to-end with Claude Code. Any MCP-compatible client should work — Claude Desktop and ChatGPT (with MCP) both speak the same protocol. If you hit a snag with a client we haven't tested, let us know and we'll dig in.

What if my token leaks?

+
Revoke it immediately at /dashboard/settings/integrations. Revocation is instant — the next MCP call fails and the offending client disconnects. Mint a fresh token and paste it into your config to recover.

Ready to plug in?

If you're already a Sposai customer, mint a token and you're minutes from chatting with your wedding from any MCP client. New here? Start a wedding first, then come back.