npm package: @scribesight/mcp-server
Description: MCP server for Scribe Sight - enables AI assistants to interact with your recordings and insights
Author: Scribe Sight
Latest version: 1.0.1

# Scribe Sight MCP Server

An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that enables AI assistants to interact with your Scribe Sight recordings, transcripts, and insights.

## Features

- 📖 **Read Resources** - Access your organization, projects, recordings, transcripts, and analysis results
- 🔧 **Use Tools** - List content, get transcripts, trigger analyses, and generate insights
- 🔐 **Secure** - Uses your Scribe Sight API key with org/project scoping
- 📡 **Real-time** - Query the latest data directly from Scribe Sight

## Installation

### For Claude Desktop

Add to your Claude Desktop configuration file:

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "scribesight": {
      "command": "npx",
      "args": ["-y", "@scribesight/mcp-server"],
      "env": {
        "SCRIBESIGHT_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}
```

### For Cursor

Add to your Cursor MCP configuration (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "scribesight": {
      "command": "npx",
      "args": ["-y", "@scribesight/mcp-server"],
      "env": {
        "SCRIBESIGHT_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}
```

### Manual Installation

```bash
npm install -g @scribesight/mcp-server
```

Then run:

```bash
SCRIBESIGHT_API_KEY=sk_live_xxx scribesight-mcp
```

## Configuration

| Environment Variable | Required | Description |
|---------------------|----------|-------------|
| `SCRIBESIGHT_API_KEY` | Yes | Your Scribe Sight API key. See [API Authentication](https://docs.scribesight.com/api/authentication) |
| `SCRIBESIGHT_BASE_URL` | No | Override the API URL (for development) |

## Available Resources

Resources are read-only data that AI assistants can access:

| URI Pattern | Description |
|------------|-------------|
| `scribesight://org` | Your organization details |
| `scribesight://projects` | List of all projects |
| `scribesight://projects/{projectId}` | Single project details |
| `scribesight://projects/{projectId}/content` | Content in a project |
| `scribesight://content/{contentId}` | Single content details |
| `scribesight://content/{contentId}/transcript` | Full transcript text |
| `scribesight://content/{contentId}/analyses` | List of analyses |
| `scribesight://analyses/{analysisId}` | Single analysis result |
| `scribesight://projects/{projectId}/insights` | Project insights |
| `scribesight://prompts` | Available analysis prompts |

## Available Tools

Tools are actions that AI assistants can perform:

### Organization & Projects

| Tool | Description |
|------|-------------|
| `get_organization` | Get organization details |
| `list_projects` | List all projects |
| `get_project` | Get a specific project |

### Content & Transcripts

| Tool | Description |
|------|-------------|
| `list_content` | List content with optional filters (status, date range) |
| `get_content` | Get content details |
| `get_transcript` | Get the full transcript text |
| `request_upload_url` | Get a presigned URL to upload new content |
| `search_content` | Search for content across projects by filename or transcript |

### Analyses

| Tool | Description |
|------|-------------|
| `list_analyses` | List analyses for a content item |
| `get_analysis` | Get a specific analysis |
| `trigger_analysis` | Trigger AI analysis on content |

### Project Insights

| Tool | Description |
|------|-------------|
| `get_project_insights` | Get latest aggregate insights |
| `list_project_insights_history` | Get historical insights |
| `trigger_project_insights` | Generate new project insights |

### Prompts

| Tool | Description |
|------|-------------|
| `list_prompts` | List available analysis prompts |
| `get_prompt` | Get a specific prompt |

### Team Members

| Tool | Description |
|------|-------------|
| `list_members` | List all organization members |
| `get_member` | Get details about a specific member |
| `invite_member` | Invite a new member via email |
| `update_member_role` | Change a member's role |
| `remove_member` | Remove a member from the organization |

### Invitations

| Tool | Description |
|------|-------------|
| `list_invitations` | List pending invitations |
| `revoke_invitation` | Cancel a pending invitation |
| `resend_invitation` | Resend an invitation email |

## Example Usage

Once configured, you can ask your AI assistant questions like:

- *"What projects do I have in Scribe Sight?"*
- *"Show me the transcript from my latest recording"*
- *"What are the key insights from my sales calls this week?"*
- *"Analyze my latest customer support call"*
- *"What were the main discussion points in the Project X recordings?"*
- *"Who are the members of my organization?"*
- *"Invite john@example.com as a contributor"*
- *"Show me pending invitations"*

## API Scoping

The MCP server respects API key scoping:

- **Organization-level keys** - Access all projects and content
- **Project-level keys** - Access only specified projects

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Watch mode
npm run dev
```

## Troubleshooting

### "SCRIBESIGHT_API_KEY environment variable is required"

Make sure your API key is set in the MCP configuration. The key should start with `sk_live_` or `sk_test_`.

### "Invalid API key"

Check that your API key is valid and hasn't been revoked. See [API Authentication](https://docs.scribesight.com/api/authentication) for details.

### Resources not loading

Ensure your API key has access to the requested resources. Project-scoped keys can only access their assigned projects.

## License

MIT

## Links

- [Scribe Sight](https://scribesight.com)
- [API Documentation](https://docs.scribesight.com)
- [MCP Protocol](https://modelcontextprotocol.io/)