MCP Directory

InstantDB MCP

Create, manage, and query your InstantDB apps, schemas, permissions, and data from your AI editor.

Unverified
HTTP (remote)
OAuth
TypeScript
View repo 10k Website npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run
npx -y @instantdb/mcp --token <token>

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "instantdb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.instantdb.com/mcp"
      ]
    }
  }
}

Claude Desktop connects to remote servers through the `mcp-remote` proxy (installed on first run via npx). Restart Claude Desktop after saving.

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

  • An InstantDB account (sign up at instantdb.com)
  • For the remote server: complete the OAuth flow to grant access to your Instant account
  • For the local stdio server: a personal access token from your Instant dashboard, and Node.js >= 18

About InstantDB MCP

Official MCP server for InstantDB, the real-time multiplayer backend. It wraps the Instant Platform SDK so AI editors can create, manage, and update Instant apps — fetching and pushing schemas and permissions, running InstaQL queries, and executing transactions. Offered both as a hosted remote server (OAuth, streamable HTTP or SSE) and as a local stdio server installed via npx with a personal access token.

Tools & capabilities (7)

learn

If you don't have any context provided about InstantDB, use this tool to learn about it. Points the LLM to Instant's rules/AGENTS.md file.

get-schema

Fetch the schema for an app by its ID (uses instant-cli pull schema to populate a local instant.schema.ts).

get-perms

Fetch the permission rules for an app by its ID (uses instant-cli pull perms to populate a local instant.perms.ts).

push-schema

Push local schema changes for an app to the server after editing instant.schema.ts (supports field renames via --rename).

push-perms

Push local permission changes for an app to the server after editing instant.perms.ts.

query

Execute an InstaQL query against an app and return the results as JSON.

transact

Execute a transaction against an app to create, update, link/unlink, or delete data using the internal transaction step format.

What this server can do

InstantDB MCP provides tools for these capabilities — tap one to see every MCP server that does the same:

Inspect database schema

When to use it

  • Building full-stack InstantDB apps directly from your AI editor (Cursor, Claude Code, Claude Desktop, Windsurf, Codex, Gemini, Zed)
  • Inspecting and updating an app's schema and permission rules from natural-language prompts
  • Querying app data with InstaQL and writing data via transactions while developing
  • Managing multiple Instant apps without leaving your editor

Security notes

The hosted remote server (https://mcp.instantdb.com/mcp) uses an OAuth flow to grant access to your Instant account. The local stdio server requires a personal access token from your Instant dashboard, passed via --token or the INSTANT_ACCESS_TOKEN environment variable; treat this token as a secret since it grants full management access to your Instant apps, schemas, permissions, and data.

InstantDB MCP FAQ

Do I need to install anything to use the remote server?

No. Point your client at https://mcp.instantdb.com/mcp (streamable HTTP) or https://mcp.instantdb.com/sse (legacy SSE). You'll be sent through an OAuth flow to grant access to your Instant account.

How do I run it locally instead?

Get a personal access token from your Instant dashboard, then run `npx -y @instantdb/mcp --token <token>` in stdio mode. You can also set INSTANT_ACCESS_TOKEN instead of passing --token.

How do I add it to Claude Code?

On a paid Claude plan, run `claude mcp add instant -s user -t http https://mcp.instantdb.com/mcp`, then run /mcp in Claude Code and complete the auth flow.

Is this the official InstantDB MCP server?

Yes. It lives in the official instantdb/instant repository under client/packages/mcp and is published to npm as @instantdb/mcp.

#instantdb#database#realtime#backend#schema#permissions#instaql#oauth

Alternatives to InstantDB MCP

Compare all alternatives →
MCP Toolbox for Databases (BigQuery)
Databases
16k

Google's official MCP server with prebuilt BigQuery tools, querying datasets via Application Default Credentials.

Verified
stdio (local)
OAuth
Go
10 tools
Updated 23 days agoRepo
DBHub
Databases
3.0k

Zero-dependency, token-efficient database MCP server for Postgres, MySQL, SQL Server, MariaDB, and SQLite.

Unverified
stdio (local)
No auth
TypeScript
3 tools
Updated 1 day agoRepo
Postgres MCP Pro
Databases
2.9k

Read/write Postgres access plus index tuning, EXPLAIN plans, and database health analysis for AI agents.

Verified
stdio (local)
API key
Python
9 tools
Updated 3 months agoRepo

Compare InstantDB MCP with:

vs MCP Toolbox for Databases (BigQuery)vs DBHubvs Postgres MCP Provs Supabase MCP Server