Repository navigation
v1.0.0 — Enterprise FuseBase MCP Platform (175 Tools, Dual Transport & Docker)
Release v1.0.0 — Enterprise FuseBase MCP Platform
🌐 Interactive Architecture & Live Status Dashboard: fusebase-mcp.thefusebase.app
Searchable directory of all 175 tools, schema parameters, 17 test suite metrics, system architecture, and milestone chronology.
🌟 Overview
FuseBase MCP Server v1.0.0 is an enterprise-grade Model Context Protocol (MCP) platform enabling autonomous AI coding agents (Claude Code, Cursor, OpenAI Codex, Antigravity, Devin, Aider, OpenCode) and developers to programmatically control the entire FuseBase (formerly Nimbus Note) ecosystem.
This release establishes 100% feature coverage across collaborative Y.js documents, relational Kanban databases, client portals, ActivePieces automations, Gate PostgreSQL isolated stores, token lifecycles, and multi-agent swarm orchestration.
🚀 Key Highlights & New Capabilities
1. Universal Agent Guidance & Zero Context Clutter (AGENTS.md)
- Two-Tier System (34 Core vs 141 Extended): To protect agent context windows from schema pollution (~15,000–20,000 tokens), the server boots in Core Tier covering all everyday CRUD. Extended tools are unlocked dynamically on demand (
set_tool_tier({ tier: "all" })orFUSEBASE_TOOLS=all). - Standardized Playbooks: Added
AGENTS.mdandCLAUDE.mdinstructing agents on zero-browser auth, token economics, table blocks vs dashboard databases, and safe handling of[DESTRUCTIVE]tools.
2. Dual-Transport Architecture (Stdio + Network HTTP/SSE)
- Stdio Transport (Default): Drop-in local pipe execution for desktop agent IDEs (
node dist/index.js). - Streamable HTTP / SSE Transport: Run as a standing network microservice (
--transport sse --port 3000orMCP_TRANSPORT=sse).- Includes
/healthstatus endpoint. - Per-session transport isolation with
/sseand/messagerouting. - Permissive CORS headers for browser-based agents and web dashboards.
- Includes
3. Docker Containerization (~150MB Lightweight Alpine)
- Multi-stage
Dockerfilebuilt onnode:20-alpine. - Non-root execution (
nodeuser) with persistent/app/datavolume for credentials. - Zero-install execution via Stdio (
docker run -i --rm ...) or SSE (docker compose up -d).
4. Direct Gate & Dashboards Token Bridge (Zero-Browser)
- Connect directly to FuseBase Gate (
https://gate-mcp.thefusebase.com/mcp) and Dashboards (https://dashboards-mcp.thefusebase.com/mcp) usingFUSEBASE_GATE_TOKENandFUSEBASE_DASHBOARDS_TOKEN. - Automatically discovers tenant organization ID (
orgId), custom domain host, and default workspace ID via upstreamwhoami. - Fully autonomous: No Chromium dependencies or interactive browser captchas needed.
5. Full-Spectrum Platform Toolsuite (175 Tools)
- Pages & Documents: Real-time Y.js CRDT synchronization, non-destructive block appending (
append_page_content), GitHub callout hint blocks, syntax highlighting, and Markdown conversion (get_page_content(format: "markdown")cuts tokens by ~50%). - Relational Databases & Dashboards: Full table lifecycle, typed columns (Text, Progress, Select, Multi-select, Date, Rating, Checkbox, Number, Currency, Formula, Lookup), Kanban views, cross-table relations, and CSV import/export.
- Client Portals: Availability inspection, themes, navigation trees, client permission management, and 24h passwordless magic links.
- Workflow Automations: ActivePieces integration with 72 connector pieces, flow lifecycle, and test triggers.
- PostgreSQL Isolated Stores: Tenant SQL database provisioning, direct query execution, and migration bundle application.
- FuseBase Work, Firecrawl & n8n: Web scraping via hosted Firecrawl and n8n workflow triggers.
- Multi-Agent Swarm Orchestrator: Shared Kanban state machines for 6 agent roles (PM, Architect, Dev, QA, Review, DevOps).
- Native Resources & Prompts: 8 native MCP resources and 17 engineered workflow prompt templates.
- Offline Guides Catalog: 278 official FuseBase documentation guides indexed across 19 categories.
⚡ Quick Start
Option A: Docker (Zero-Install — Recommended)
Run locally via Stdio (for Cursor, Claude Desktop):
docker run -i --rm \
-e FUSEBASE_GATE_TOKEN="your_token" \
-e FUSEBASE_DASHBOARDS_TOKEN="your_token" \
-e FUSEBASE_TOOLS="all" \
fusebase-mcp:latestRun as a standing Network SSE Service:
docker run -d --name fusebase-mcp -p 3000:3000 \
-e FUSEBASE_GATE_TOKEN="your_token" \
-e FUSEBASE_DASHBOARDS_TOKEN="your_token" \
-e MCP_TRANSPORT="sse" \
fusebase-mcp:latest
# SSE: http://localhost:3000/sse | Health: http://localhost:3000/healthOption B: Local Node.js
git clone https://github.com/ryan-haver/fusebase-mcp.git
cd fusebase-mcp
npm install && npm run build
node dist/index.js🤖 Client Configuration Templates
Cursor IDE (.cursor/mcp.json)
{
"mcpServers": {
"fusebase": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"FUSEBASE_GATE_TOKEN": "your_gate_token",
"FUSEBASE_DASHBOARDS_TOKEN": "your_dashboards_token",
"FUSEBASE_TOOLS": "all"
}
}
}
}Claude Desktop / Claude Code
{
"mcpServers": {
"fusebase": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"FUSEBASE_GATE_TOKEN": "your_gate_token",
"FUSEBASE_DASHBOARDS_TOKEN": "your_dashboards_token",
"FUSEBASE_TOOLS": "all"
}
}
}
}Or via Claude Code CLI:
claude plugin add .Docker Drop-in for Any Client
{
"mcpServers": {
"fusebase": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "FUSEBASE_GATE_TOKEN",
"-e", "FUSEBASE_DASHBOARDS_TOKEN",
"-e", "FUSEBASE_TOOLS=all",
"fusebase-mcp:latest"
]
}
}
}📊 Verification & Validation
| Domain | Metrics | Status |
|---|---|---|
| Production Tools | 175 Tools (34 Core, 141 Extended) | ✅ 100% Verified |
| Automated Assertions | 17 Test Suites, 212 Passed Assertions | ✅ 100% Verified |
| Token vs Cookie Parity | 11 Core Functional Domains | ✅ 100% Verified |
| Transports | Stdio (Local) + HTTP/SSE (Network) + Docker | ✅ 100% Verified |
| Live Engineering Dashboard | Hosted on FuseBase Cloud at fusebase-mcp.thefusebase.app |
✅ Operational |
Full Changelog: https://github.com/ryan-haver/fusebase-mcp/commits/v1.0.0