Skip to content

v1.0.0 — Enterprise FuseBase MCP Platform (175 Tools, Dual Transport & Docker)

Choose a tag to compare

@ryan-haver ryan-haver released this 23 Sep 04:52
· 36 commits to master since this release

Release v1.0.0 — Enterprise FuseBase MCP Platform

Version
Live Status Dashboard
Production Tools
Automated Assertions
Docker Ready
Feature Parity

🌐 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" }) or FUSEBASE_TOOLS=all).
  • Standardized Playbooks: Added AGENTS.md and CLAUDE.md instructing 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 3000 or MCP_TRANSPORT=sse).
    • Includes /health status endpoint.
    • Per-session transport isolation with /sse and /message routing.
    • Permissive CORS headers for browser-based agents and web dashboards.

3. Docker Containerization (~150MB Lightweight Alpine)

  • Multi-stage Dockerfile built on node:20-alpine.
  • Non-root execution (node user) with persistent /app/data volume 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) using FUSEBASE_GATE_TOKEN and FUSEBASE_DASHBOARDS_TOKEN.
  • Automatically discovers tenant organization ID (orgId), custom domain host, and default workspace ID via upstream whoami.
  • 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:latest

Run 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/health

Option 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