MCP Directory

How to add InstantDB MCP to Windsurf

Create, manage, and query your InstantDB apps, schemas, permissions, and data from your AI editor. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 10k★ · http · oauth

Windsurf config for InstantDB MCP

npx -y @instantdb/mcp --token <token>
{
  "mcpServers": {
    "instantdb-mcp": {
      "serverUrl": "https://mcp.instantdb.com/mcp"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the InstantDB MCP config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5InstantDB MCP's tools become available to Cascade.

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

What InstantDB MCP can do in Windsurf

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.

Security

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the InstantDB MCP config there under the "mcpServers" key and restart the client.

Is InstantDB MCP safe to use with Windsurf?

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.

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.

View repo Full InstantDB MCP page