Which integrations are available for this server?

Loads environment variables from .env files to configure the InstantDB connection with essential variables like INSTANT_APP_ID and INSTANT_APP_ADMIN_TOKEN. Supports installation on macOS systems with specific configuration paths for Claude Desktop integration. Uses npm for package management, installation of dependencies, and running build and development scripts.

How do I use InstantDB MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@InstantDB MCP Server show me some example queries for filtering data" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

instantdb-server MCP Server

An MCP server for interacting with InstantDB.

This server provides a read-only interface for querying InstantDB using a dynamically loaded schema and environment configuration. It includes tools to execute queries and retrieve query examples based on pre-defined patterns.

Features

Tools

get_examples
Returns pre-defined example queries for various categories (e.g., "basic_read", "filtering", "associations").
queryDB
Executes a specific query against InstantDB. Requires a query and a descriptive name parameter.
list_queries
Retrieves the history of executed queries with details such as query ID, name, timestamp, and structure.
return_query
Retrieves a specific query by its unique ID for later reference or implementation.

Schema and Environment Integration

Dynamic loading of the InstantDB schema from common file locations relative to a provided project directory (e.g., instant.schema.ts, src/instant.schema.ts, app/instant.schema.ts).
Environment variable configuration is loaded from the project’s .env file. Essential variables include:
- INSTANT_APP_ID
- INSTANT_APP_ADMIN_TOKEN

Pending Features

Dynamic detection of the InstantDB permissions file from common file locations.

Related MCP server: MySql MCP Server

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use the server with Claude Desktop, add the following configuration to your Claude Desktop settings:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

Example configuration:

{ "mcpServers": { "instantdb-server": { "command": "node", "args": ["/path/to/instantdb-server/build/index.js"], "env": { "INSTANT_APP_ID": "your_app_id", "INSTANT_APP_ADMIN_TOKEN": "your_admin_token" }, "disabled": false, "autoApprove": [] } } }