npm package: @fragmentfit/mcp-server
Description: MCP server for Fragment meeting intelligence
Latest version: 1.1.1

<p align="center">
  <a href="https://fragment.fit">
    <img src="https://raw.githubusercontent.com/fragment-fit/sdks/main/packages/mcp-server/assets/fragment-logo.svg" alt="Fragment" width="200" />
  </a>
</p>

# @fragmentfit/mcp-server

MCP server that gives AI assistants — Claude Desktop, Claude Code, Cursor — read access to your [Fragment](https://fragment.fit) meeting intelligence data.

## What is Fragment?

[Fragment](https://fragment.fit) is an AI-powered customer research platform for B2B teams. It automatically analyzes customer conversations across multiple sources (Zoom, Gong, Google Drive, and more) to extract actionable insights, surface themes, and identify patterns — delivering research-quality insights in minutes, not weeks.

## How it works

This package runs as a local process on your machine. When an AI assistant needs to answer questions about your meetings, feedback, or themes, it calls this server over stdio. The server translates those requests into Fragment API calls using your API key.

```
┌─────────────────┐     stdio      ┌──────────────────┐     HTTPS     ┌─────────────────┐
│  Claude Desktop │ ◄────────────► │  fragment-mcp    │ ◄───────────► │  Fragment API   │
│  Claude Code    │    MCP proto   │  (this package)  │   REST calls  │  api.fragment.fit│
│  Cursor         │                │  runs locally    │               │                 │
└─────────────────┘                └──────────────────┘               └─────────────────┘
```

## Prerequisites

- Node.js 22 or later
- A Fragment account and API key

### Create a Fragment account

Fragment is available to B2B teams via a guided onboarding. To get started:

1. Visit [fragment.fit](https://fragment.fit) and book a demo
2. Once your workspace is set up, sign in at [app.fragment.fit](https://app.fragment.fit)

## Get your API key

1. Open Fragment → Settings → API Keys
2. Click **Create API Key**
3. Copy the key or download the key file — you only see it once
4. The key starts with `frag_live_`

## Setup

### Claude Code

```bash
claude mcp add fragment -e FRAGMENT_API_KEY=frag_live_YOUR_KEY_HERE -- npx -y @fragmentfit/mcp-server
```

If you downloaded the key file:

```bash
API_KEY=$(grep '^frag_' ~/Downloads/YOUR_KEY_FILE.txt)
claude mcp add fragment -e FRAGMENT_API_KEY=$API_KEY -- npx -y @fragmentfit/mcp-server
```

Verify it's connected:

```bash
claude mcp list
```

Then start a conversation and ask Claude: **"List my recent sessions using Fragment"**.

**More options:**

```bash
# Project-scoped (only available in this project)
claude mcp add fragment -s project -e FRAGMENT_API_KEY=frag_live_... -- npx -y @fragmentfit/mcp-server

# Remove the server
claude mcp remove fragment
```

### Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "fragment": {
      "command": "npx",
      "args": ["-y", "@fragmentfit/mcp-server"],
      "env": {
        "FRAGMENT_API_KEY": "frag_live_..."
      }
    }
  }
}
```

Restart Claude Desktop. Click the hammer icon in the chat input to see the 15 Fragment tools.

### Cursor

Add to Cursor Settings → MCP Servers:

```json
{
  "fragment": {
    "command": "npx",
    "args": ["-y", "@fragmentfit/mcp-server"],
    "env": {
      "FRAGMENT_API_KEY": "frag_live_..."
    }
  }
}
```

## Available tools

| Tool | What it does |
|------|-------------|
| `list_sessions` | List meetings with pagination, search, and folder filtering |
| `get_session` | Get full details for a single meeting (meta-analysis, participants) |
| `get_session_transcript` | Get the full meeting transcript |
| `get_speaker_transcript` | Get the transcript with speaker names identified |
| `search_feedbacks` | Search and filter feedback items across meetings |
| `get_feedback` | Get a single feedback item with full details |
| `list_themes` | List extracted themes and patterns from your feedback |
| `get_theme` | Get theme details including recommendations and related themes |
| `get_company_context` | Get your organization's company context |
| `list_companies` | List all companies/accounts in your organization |
| `list_tags` | List tags used to categorize feedback |
| `list_folders` | List folders used to organize sessions |
| `get_notes` | Get notes and annotations for a specific session |
| `get_stats` | Get aggregate stats (feedback and session counts) |
| `get_usage` | Get feedback type breakdown across session types |

All tools are read-only. They cannot modify your data.

## Example prompts

Once connected, try asking your AI assistant:

- "List my recent sessions"
- "Show me the transcript for session [name]"
- "What are the top themes from my meetings?"
- "What feedback came from [company name]?"
- "Summarize the key insights from last week's sessions"
- "What are the most common pain points across all feedback?"

## Troubleshooting

| Problem | Fix |
|---------|-----|
| Server not connecting | Run `claude mcp list` to check status. Re-run the `claude mcp add` command if needed. |
| "Authentication failed" | Your API key is invalid or expired. Create a new one in Fragment → Settings → API Keys. |
| "FRAGMENT_API_KEY environment variable is required" | The API key wasn't passed. Re-run `claude mcp add` with the `-e FRAGMENT_API_KEY=...` flag. |
| Tools return errors | Verify your Fragment account is active and you have data in your workspace. |

## Environment variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `FRAGMENT_API_KEY` | Yes | — | Your Fragment API key (starts with `frag_live_`) |
| `FRAGMENT_API_URL` | No | `https://api.fragment.fit` | Fragment API base URL |