@ai-native-solutions/fallbase-mcp

Model Context Protocol server exposing the FallBase sovereign SQL database to Claude, Cursor, and any other MCP-compatible client.

Stdio transport. Uses @modelcontextprotocol/sdk.

Install and wire up

npm install -g @ai-native-solutions/fallbase-mcp

Add to Claude Code:

claude mcp add fallbase npx @ai-native-solutions/fallbase-mcp

Or add to your MCP client config directly:

{
  "mcpServers": {
    "fallbase": {
      "command": "npx",
      "args": ["-y", "@ai-native-solutions/fallbase-mcp"],
      "env": {
        "FALLBASE_STATE": "./fallbase-state.json"
      }
    }
  }
}

State persists to FALLBASE_STATE (default ./fallbase-state.json) after every mutation.

Tools

tool	description
query	Run a SELECT — supports JOIN, WHERE, GROUP BY, HAVING, ORDER BY, LIMIT, DISTINCT, aggregates (COUNT/SUM/AVG/MIN/MAX), and predicates (BETWEEN, IN, IS [NOT] NULL, LIKE).
create_table	Declare a table with typed columns (integer, real, text, boolean, date, json).
insert	Insert a row. Auto-increments integer primary keys.
list_tables	Snapshot of the schema with row counts.
export_csv	Export a table as CSV.
import_csv	Load CSV text into a table. Pass create_table: true to auto-create it from the header row.

Resources

• fallbase://db — active database JSON snapshot.
• fallbase://table/<name> — one table's cols + rows.

Try it

Once wired up in Claude Code:

Create a customers table with id (integer PK), name (text), status (text), credit_limit (real). Insert three rows. Then group by status.

Claude will call create_table, insert x3, then query.

Related

• @ai-native-solutions/fallbase-sdk — the underlying engine (tokenizer, parser, executor, CSV I/O). No dependencies.
• @ai-native-solutions/fallbase-api — Express HTTP wrapper with Docker.
• fallbase — original single-file browser tool.

License

MIT