MCP Server

What is MCP

The Model Context Protocol (MCP) is an open standard that allows AI applications to connect to external data sources and tools. It provides a standardized way for AI assistants to access your data securely, without you having to copy and paste information back and forth.

The Karnyx MCP server exposes your meeting data as a set of tools that any MCP-compatible AI client can call. This means you can ask Claude Desktop a question like "What did we decide about pricing in last week's product sync?" and Claude will use the Karnyx MCP server to search your meetings, retrieve the relevant transcript, and provide the answer.

Setting Up the MCP Server

The Karnyx MCP server is distributed as an npm package. You need Node.js 18 or later installed on your machine.

Step 1: Generate an API Key

1. Open the Karnyx desktop app.
2. Go to Settings > API > API Keys.
3. Click "Create API Key".
4. Name the key (e.g., "MCP Server") and copy the generated key. Store it securely as it will not be shown again.

Step 2: Install the Package

npm install -g @karnyx/mcp-server

Step 3: Configure the Server

Set your API key as an environment variable, or pass it directly when starting the server:

# Option 1: Environment variable
export KARNYX_API_KEY="your_api_key_here"
karnyx-mcp-server

# Option 2: Inline
KARNYX_API_KEY="your_api_key_here" karnyx-mcp-server

# The server starts on stdio transport by default
# (required for Claude Desktop and Cursor integration)

Connecting from Claude Desktop

To add the Karnyx MCP server to Claude Desktop, edit your Claude Desktop configuration file.

macOS Configuration

Open (or create) the file at ~/Library/Application Support/Claude/claude_desktop_config.json and add the Karnyx server:

{
  "mcpServers": {
    "karnyx": {
      "command": "npx",
      "args": ["-y", "@karnyx/mcp-server"],
      "env": {
        "KARNYX_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop after saving the configuration. You should see a small hammer icon in the input bar indicating that MCP tools are available.

Connecting from Cursor

Cursor supports MCP servers through its configuration file. Add the Karnyx server to your Cursor MCP config.

Configuration

Open (or create) the file at ~/.cursor/mcp.json and add:

{
  "mcpServers": {
    "karnyx": {
      "command": "npx",
      "args": ["-y", "@karnyx/mcp-server"],
      "env": {
        "KARNYX_API_KEY": "your_api_key_here"
      }
    }
  }
}

After saving, restart Cursor. The Karnyx tools will be available in Cursor's AI chat and Composer panels.

Available Tools

The Karnyx MCP server exposes five tools that AI clients can use to interact with your meeting data.

// Parameters
{
  "query": "string",         // Search query (natural language)
  "from_date": "string?",    // ISO 8601 start date filter
  "to_date": "string?",      // ISO 8601 end date filter
  "participants": "string[]?", // Filter by participant emails
  "company": "string?",      // Filter by company name
  "limit": "number?"         // Max results (default: 10)
}

// Parameters
{
  "meeting_id": "string"     // The meeting ID (e.g., "mtg_a1b2c3d4")
}

// Parameters
{
  "meeting_id": "string",    // The meeting ID
  "from_time": "number?",    // Start time in seconds (optional)
  "to_time": "number?",      // End time in seconds (optional)
  "speaker": "string?"       // Filter by speaker name (optional)
}

// Parameters
{
  "lens_name": "string",     // Lens name (e.g., "Competitor Mentions")
  "meeting_ids": "string[]"  // One or more meeting IDs to analyze
}

// Parameters
{
  "question": "string",      // Your question in natural language
  "scope": "string?",        // Optional: "all", "person:email", "company:name"
  "from_date": "string?",    // Optional date filter
  "to_date": "string?"       // Optional date filter
}

Example Queries

Here are examples of how you can use Karnyx tools in Claude Desktop or Cursor. The AI assistant will automatically choose the right tool(s) based on your question.