Claude Code

Claude Code supports remote MCP servers natively. The fastest path is one terminal command — no JSON editing required.

Prerequisites

A Chartcastr account on any paid plan
Claude Code installed (npm install -g @anthropic-ai/claude-code)
An API key from Settings → API Keys

Setup (recommended: one-liner)

claude mcp add --transport http chartcastr \
  https://api.chartcastr.com/api/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Replace YOUR_API_KEY with the key from your dashboard. Claude Code persists the server in your user config and loads it on next startup. To restrict the install to one project, add --scope project. Verify with /mcp — chartcastr should appear in the list.

Setup (alternative: `.mcp.json`)

Prefer to commit a project-scoped config? Create .mcp.json at your project root and add it to .gitignore to keep your key private:

{
  "mcpServers": {
    "chartcastr": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.chartcastr.com/api/mcp",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

Restart Claude Code or run /mcp to load.

Available tools

Tool	Description
`list_sources`	List all data sources connected to your account
`list_destinations`	List all configured destinations (Slack, email, etc.)
`list_connections`	List all active chart delivery connections
`get_latest_pulse`	Fetch the most recent pulse analysis for a connection
`verify_connection`	Confirm a connection is active and delivering
`open_chartcastr`	Generate a deep link to open Chartcastr in your browser

Example prompts

“What data sources do I have in Chartcastr?”
“Show me all my active connections and their schedules.”
“What did the latest pulse say about my HubSpot connection?”
“Is my Google Sheets → Slack connection still running?”

Local development

Running Chartcastr locally with bun up? Point at your local server:

claude mcp add --transport http chartcastr-local \
  http://localhost:8109/api/mcp \
  --header "X-API-Key: YOUR_LOCAL_KEY"

Troubleshooting

Authentication error (401)

Your key is wrong, expired, or revoked. Regenerate at Settings → API Keys and re-run claude mcp add (it overwrites the existing entry).

Tool not found or unavailable

Some tools may be disabled during rollout. Run /mcp to see what’s exposed by the server, and contact support if you need access to a specific capability.

Claude Code doesn't see the chartcastr server

Run claude mcp list to confirm it’s registered. If it’s there but Claude Code doesn’t show it, fully quit and relaunch. If it’s missing, the install command failed — re-run it and check the terminal output.

Getting Started

Sources

Destinations

Analysis

Stats

AI Tools

API

Streams

Admin

Prerequisites

Setup (recommended: one-liner)

Setup (alternative: `.mcp.json`)

Available tools

Example prompts

Local development

Troubleshooting

​Prerequisites

​Setup (recommended: one-liner)

​Setup (alternative: .mcp.json)

​Available tools

​Example prompts

​Local development

​Troubleshooting

Prerequisites

Setup (recommended: one-liner)

Setup (alternative: `.mcp.json`)

Available tools

Example prompts

Local development

Troubleshooting