> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude (Desktop)

> Connect Claude's desktop app to Chartcastr via MCP and query your data sources, connections, and pulse analysis directly from your conversations.

## Overview

The [Claude desktop app](https://claude.ai/download) supports MCP servers natively. Once configured, you can ask Claude about your Chartcastr account without switching to a browser.

## Prerequisites

* Claude desktop app installed (macOS or Windows)
* A Chartcastr account on any paid plan
* An API key from **Settings → API Keys** in your Chartcastr dashboard

## Setup

### 1. Generate an API key

In Chartcastr, go to **Settings → API Keys** and create a new key.

### 2. Edit the Claude config file

Open the config file for your platform in a text editor:

<Tabs>
  <Tab title="macOS">
    ```
    ~/Library/Application Support/Claude/claude_desktop_config.json
    ```
  </Tab>

  <Tab title="Windows">
    ```
    %APPDATA%\Claude\claude_desktop_config.json
    ```
  </Tab>
</Tabs>

If the file doesn't exist yet, create it.

### 3. Add the Chartcastr MCP server

Paste the following, replacing `YOUR_API_KEY`:

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

### 4. Restart Claude

Quit and reopen the Claude desktop app. A small hammer icon will appear in the text input area when MCP tools are available.

## 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 AI analysis for a connection    |
| `verify_connection` | Confirm a connection is active                        |
| `open_chartcastr`   | Generate a deep link to open Chartcastr               |

## Example Prompts

* *"What data sources do I have in Chartcastr?"*
* *"Show me all my active connections."*
* *"What did the latest pulse say about my HubSpot connection?"*

## Further Reading

* [Claude MCP setup guide](https://modelcontextprotocol.io/quickstart/user) — official MCP docs for Claude desktop
* [Chartcastr API Keys](https://chartcastr.com/admin/settings/api-keys?create=true) — manage your keys