@instantdb/mcp

Get Started · Examples · Docs · Discord

Welcome to Instant's MCP server.

Instant MCP

This MCP is a wrapper around the Instant Platform SDK. Add this MCP to your editor to enable creating, managing, and updating your InstantDB applications.

Remote MCP server

Instant hosts the latest version of the server at https://mcp.instantdb.com.

For modern clients that support streamable HTTP use https://mcp.instantdb.com/mcp.

For legacy clients that require SSE use https://mcp.instantdb.com/sse.

For more editor-specific instructions, see the public docs.

Local MCP server

If you haven't already, make sure to get a personal access token from your Instant dashboard.

Run the server in stdio mode with npx -y @instantdb/mcp --token <token>.

For more editor-specific instructions, see the public docs.

Contributing

Quick Start

Clone this repo and use the MCP Inspector @modelcontextprotocol/inspector to debug and develop against this server locally.

# Clone this repo
git clone ..

# Navigate to the cloned directory and build the MCP server
cd ..
npm run build

# Run the server
npx @modelcontextprotocol/inspector node ./dist/index.js --token <token>

# Or alternatively via environment variable
INSTANT_ACCESS_TOKEN=<token> npx @modelcontextprotocol/inspector node ./build/index.js

# You can also specify a url to connect to a local instance of your instant server
npx @modelcontextprotocol/inspector node ./dist/index.js --token <token> --api-url
http://localhost:8888

If you're using Claude Code you can add the mcp server directly after building:

claude mcp add --transport stdio instant-local -- node <path-to-your-cloned-repo>/dist/index.js --token <token>

You can then remove the server directly:

claude mcp remove instant-local

You can also configure your editor to connect to your local MCP. Here's an example configuration for MacOS/Linux:

{
  "mcpServers": {
    "instant": {
      "command": "node",
      "args": [
        "<path-to-your-cloned-repo>/dist/index.js",
        "--token",
        "<token>",
        "--api-url",
        "http://localhost:8888"
      ]
    }
  }
}

Remote MCP

cp .env.example .env

Fill in all of the environment variables for your new .env file.

pnpm run dev

Visit the server at http://localhost:3123.

To work on the stdio version of the codebase, update your .env file with SERVER_TYPE=stdio.