Skip to main content
Glama
SynapCores MCP Server

SynapCores MCP Server

Official

SynapCores MCP Server

Give Claude, Cursor, Windsurf, VS Code, Zed, or any Model Context Protocol client a full AI-native database. SynapCores puts SQL, vector search, a Cypher graph, in-database AutoML, LLM generation and agent memory in one self-hosted engine. This server exposes all of it as MCP tools.

  • One server, every data model. Query tables, run semantic search, traverse a graph, and train and score ML models from the same connection.

  • No SQL dialect to learn. The tools wrap the engine's AI functions, so an assistant can run semantic search or train a model directly.

  • Your data stays with you. SynapCores runs on your machine or your servers. The Community Edition is free.

  • Zero dependencies. One small Node.js package (Node 18+).

Try SynapCores in the browser first: synapcores.com/playground

Tools

Tool

What it does

list_tables

List the tables in the database

describe_table

Columns, types and constraints for a table

query

Run a SELECT and return rows

execute

Run INSERT / UPDATE / DELETE and DDL

validate_query

Check SQL and show the plan without running it

sql_manual

Look up SynapCores SQL syntax and examples

semantic_search

Top-k similarity search over a vector collection; the query text is embedded for you

embed_text

Get an embedding vector for any text

graph_query

Run Cypher (MATCH / MERGE / CREATE / SET / DELETE) on the graph

train_model

Train an AutoML model on a table column

predict

Score rows with a trained model (calibrated probabilities for classification)

list_models

List trained models

describe_model

Algorithm, metrics and feature importance of a model

generate_text

Generate text with the engine's configured LLM

agent_soul

Inspect the database's learned agent memory: episodes, rewards, runs, plans and goals

The tools come from the SynapCores engine itself, so they update when you upgrade the engine.

Related MCP server: NLQueries

1. Run SynapCores

curl -fsSL https://get.synapcores.com | sh

Or use Docker (synapcores/community on Docker Hub). See synapcores.com/download. The gateway listens on http://127.0.0.1:8080 by default.

2. Add the server to your client

Claude Code

claude mcp add synapcores \
  --env SYNAPCORES_URL=http://127.0.0.1:8080 \
  --env SYNAPCORES_TOKEN=your-api-key \
  -- npx -y @synapcores/mcp

Claude Desktop, Cursor, Windsurf, and other JSON-config clients

{
  "mcpServers": {
    "synapcores": {
      "command": "npx",
      "args": ["-y", "@synapcores/mcp"],
      "env": {
        "SYNAPCORES_URL": "http://127.0.0.1:8080",
        "SYNAPCORES_TOKEN": "your-api-key"
      }
    }
  }
}

Config file locations:

  • Claude Desktop: claude_desktop_config.json

  • Cursor: ~/.cursor/mcp.json

  • Windsurf: ~/.codeium/windsurf/mcp_config.json

VS Code

{
  "servers": {
    "synapcores": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@synapcores/mcp"],
      "env": { "SYNAPCORES_URL": "http://127.0.0.1:8080", "SYNAPCORES_TOKEN": "your-api-key" }
    }
  }
}

LangChain, LangGraph, CrewAI

Any MCP adapter works. For example, with langchain-mcp-adapters:

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "synapcores": {
        "command": "npx",
        "args": ["-y", "@synapcores/mcp"],
        "env": {"SYNAPCORES_URL": "http://127.0.0.1:8080", "SYNAPCORES_TOKEN": "your-api-key"},
        "transport": "stdio",
    }
})
tools = await client.get_tools()

Configuration

Variable

Description

SYNAPCORES_URL

Gateway URL. Default http://127.0.0.1:8080.

SYNAPCORES_TOKEN

API key or JWT (recommended). Create API keys in the SynapCores console or with POST /v1/api-keys.

SYNAPCORES_USERNAME / SYNAPCORES_PASSWORD

Log in with a username and password instead of a token. The server renews the session automatically.

SYNAPCORES_TIMEOUT_MS

Per-request timeout. Default 300000 (5 minutes).

Every tool call goes through the gateway's authentication and tenant isolation. The assistant sees only what its API key is allowed to see. For read-only exploration, give it a read-only key.

Try it

"What tables are in my SynapCores database, and how many rows does each have?"

"Train a model on customers to predict churned, then show the 10 highest-risk customers."

"Find the five support articles most similar to 'reset my password'."

How it works

MCP client  ⇄  stdio  ⇄  @synapcores/mcp  ⇄  HTTPS (JSON-RPC)  ⇄  SynapCores gateway /v1/mcp

The engine hosts the MCP server. This package connects stdio clients to it.

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Zero-config MCP server that empowers AI agents to safely query SQL and NoSQL databases like PostgreSQL, MySQL, SQLite, MongoDB, and Redis.
    5
    47 npm
    1
    MIT
  • F
    license
    A
    quality
    B
    maintenance
    Natural language to SQL engine with multi-connector support (PostgreSQL, MySQL, Snowflake, BigQuery, DuckDB), document QA, semantic caching, and self-hosted MCP server.
    9
    122 PyPI
    5
    -
  • A
    license
    Not graded
    quality
    A
    maintenance
    A dead-simple, self-hosted MCP server for querying your databases with AI agents.
    23
    66 PyPI
    2
    MIT
  • A
    license
    B
    quality
    B
    maintenance
    Enables AI assistants to connect to 17+ databases and query/analyze data using natural language via MCP and HTTP APIs, supporting platforms like Claude Desktop, Cursor, and VS Code.
    42
    25 npm
    MIT