Chartbrew MCP

by dhavanikgithub

Not rated
GitHub

About

Chartbrew + AI agents. MCP server exposing Chartbrew's documented API: teams, connections, datasets, dashboards, charts, live queries, and secure embedding. TypeScript · stdio · restricted/unrestricted tool modes.

Details

Author
dhavanikgithub
Categories
Productivity, Other, Knowledge Base

Setup

Install Chartbrew MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/dhavanikgithub/chartbrew-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

TheChartbrew MCP serverexposesChartbrew's documented API to AI coding agents and MCP-compatible clients — letting them list and inspect teams, connections, datasets, dashboards, and charts, run live queries, fetch data, manage share policies/tokens for secure embedding, and create or update resources, all through natural language.

TypeScript MCP server built on the official MCP SDK for documented Chartbrew API endpoints.

Chartbrew MCP in action — managing analytics resources through natural language.

- Node.jsandnpminstalled (used to install dependencies and build the server).
- AChartbrew API key— create one in your Chartbrew account (cloud or self-hosted). See
How to create API keys in Chartbrew.
- For a self-hosted Chartbrew instance, the API base URL of that instance (defaulthttp://localhost:4019).
- AnMCP-compatible clientto host the server (e.g. Claude Code, Claude Desktop, Cursor, VS Code, Codex, GitHub Copilot, OpenCode, Kimi Code).

This server only implements operations documented in the officialChartbrew APIreference and avoids undocumented behavior.

- Teams: list, get
- Connections: list, get, test, create, update, delete
- Datasets: list, get, fetch data, create, update, delete
- Data Requests: list, run
- Dashboards (projects): list, get, create, update, delete
- Charts: get, create, query, delete

- Variable binding create/update endpoints

Chartbrew API docs specify Bearer token authentication.

- Authorization: Bearer <CHARTBREW_API_KEY>

- unrestricted: all implemented tools are available.
- restricted: only data-retrieval/query tools are available (list/get/fetch/query/run/test). Create/update/delete tools are disabled.

You can provide these values in either of two ways (pick one):

- .envfile in thismcpfolder— copy.env-templateto.envand fill in the values. The server auto-loads it on startup.
- Theenvblock of your coding agent's MCP config— set the variables directly in theenvobject of the server entry (e.g..mcp.jsonfor Claude Code, or the equivalent MCP config for Codex, GitHub Copilot, OpenCode, Kimi Code, etc.). Use this when you don't want a local.envfile.

The server uses stdio transport and is intended to be launched by an MCP client host.

Prefer not to install Node.js? Download a prebuilt binary from theReleasespage and run it directly. Binaries are provided for:

Releases include both raw binaries and compressed archives (.zipfor Windows,.tar.gzfor Linux/macOS) — grab the archive for a smaller download, then extract it.

- Windows:downloadchartbrew-mcp-windows-x64.zip(orarm64), extract, run the.exe.
- macOS / Linux:download e.g.chartbrew-mcp-darwin-arm64.tar.gz, extract, then make it executable once:chmod +x chartbrew-mcp-darwin-arm64
- macOS Gatekeeper:if macOS blocks the unsigned binary, remove the quarantine attribute:xattr -d com.apple.quarantine chartbrew-mcp-darwin-arm64

You donotneed a.envfile — set configuration through your MCP client'senvblock (or the OS environment). Example for Claude Desktop / Claude Code (.mcp.jsonorclaude_desktop_config.json):

{ "mcpServers": { "chartbrew": { "command": "/absolute/path/to/chartbrew-mcp-darwin-arm64", "env": { "CHARTBREW_API_KEY": "your-api-key", "CHARTBREW_API_BASE_URL": "https://api.chartbrew.com", "CHARTBREW_TOOL_MODE": "restricted" } } } }

From a checkout, installBun(the compiler), then:

npm install npm run build:bin # writes binaries to dist-bin/

Full setup, Bun install commands, and the Windows cross-compile caveat are inCONTRIBUTING.md.

Afternpm installandnpm run build, register the server with your MCP host. The server runs over stdio vianode dist/index.js. Replace<ABSOLUTE_PATH_TO_MCP_DIR>with the absolute path to thismcpdirectory and set your API key.

If you use Claude Code, you can register the server directly from the terminal instead of editing a config file:

claude mcp add chartbrew \ -e CHARTBREW_API_KEY=your-api-key \ -e CHARTBREW_API_BASE_URL=https://api.chartbrew.com \ -e CHARTBREW_TOOL_MODE=restricted \ -- node <ABSOLUTE_PATH_TO_MCP_DIR>/dist/index.js

- Usehttp://localhost:4019forCHARTBREW_API_BASE_URLon a self-hosted instance (change the port if yours differs).
- Add-s user(or-s project) to control the scope the server is registered in.
- Verify withclaude mcp list; remove withclaude mcp remove chartbrew.

Claude Desktop / Claude Code (claude_desktop_config.jsonor.mcp.json)

{ "mcpServers": { "chartbrew": { "command": "node", "args": ["<ABSOLUTE_PATH_TO_MCP_DIR>/dist/index.js"], "env": { "CHARTBREW_API_KEY": "your-api-key", "CHARTBREW_API_BASE_URL": "https://api.chartbrew.com", "CHARTBREW_TOOL_MODE": "unrestricted" } } } }

Cursor / VS Code (settings UI → MCP servers)

{ "mcpServers": { "chartbrew": { "command": "node", "args": ["<ABSOLUTE_PATH_TO_MCP_DIR>/dist/index.js"], "env": { "CHARTBREW_API_KEY": "your-api-key" } } } }

API base URL:usehttps://api.chartbrew.comfor an official Chartbrew cloud account. For a self-hosted instance use your local URL — defaulthttp://localhost:4019(change the port if yours differs).

- CHARTBREW_API_KEYis required. SeeHow to create API keys in Chartbrew.
- The MCP host launches the server; it does not need to be run manually.
- The default tool mode isrestricted(read/query only). SetCHARTBREW_TOOL_MODE: "unrestricted"to also enable create/update/delete tools.
- Alternatively, set the env vars in a.envfile in themcpdirectory and omit theenvblock.

Known documentation limitations reflected in implementation

- ID types are inconsistent in docs (number vs string), so tool inputs accept strings.
- Some create/update payload required fields are not consistently documented, so payload is typed as flexible object.
- Dataset fetch filters query-object encoding is undocumented; this server sends object values as JSON strings.
- Error response schemas vary by endpoint; parser handles both error and message fields when available.

Zero-dependency persistent AI memory using SQLite. Dual-store, pluggable embeddings, 10 MCP tools.

Codebase memory for coding agents, with no embeddings and no API key. A deterministic AST index answers "which files are relevant to this task?" in milliseconds, and agents write durable notes about the repo that are content-hash checked — a note flags itself stale the moment the code it describes changes. Notes are markdown inside the repo, so they commit and review alongside your code.

Perform semantic search and retrieval augmented generation over your Apple Notes.

Search 286 episodes of product management wisdom from Lenny Rachitsky. Semantic search across 300+ hours of transcripts.

Personal knowledge graph AI memory. 15 tools, 89 actions. Semantic search, emotional intelligence, CRM, life management, social, self-training, autonomous insights, research agent, automations.

Embeddings, vector search, document storage, and full-text search with the open-source AI application database

Semantic search through Dickens' classic tale. Find passages by meaning, theme, or concept - not just keywords.

Discovery & reputation layer for AI agents: semantic search over 15,000+ agents and MCP servers, cross-registry reputation, remote MCP over Streamable HTTP, no auth.

A local, high-performance memory server for AI agents, built with SQLite, vector embeddings, and a knowledge graph. Packaged for npm and Docker.

MCP server for Apache AGE graph databases on PostgreSQL. 21 MCP tools — the most comprehensive Apache AGE MCP server (graph CRUD, Cypher queries, batch transactions, semantic search, Graph RAG, vis.js visualization, export/import) - F#/.NET — the only non-Python Apache AGE MCP server, installs as a single dotnet tool - Production-grade — BenchmarkDotNet-verified performance (cached queries in 62 ns, Cypher in 1 ms) - Open source — MIT license, published on NuGet - Documentation — full docs site at neftedollar.com/age-mcp

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.