IMS-MCP Client

MCP client for the Impact Moments RAG system. Enables Claude Desktop to search podcast transcripts semantically.

What This Does

Connects Claude Desktop to the Impact Moments podcast transcript database, allowing you to:

• Search transcripts by meaning, not just keywords
• Compare raw vs edited transcripts for voice analysis
• Generate clip suggestions for social media
• Retrieve full episode content
• List available episodes

Installation

For Claude Desktop Users

No installation needed! Just configure Claude Desktop.

Step 1: Add to Claude Desktop config

Edit your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Step 2: Add this configuration

{
  "mcpServers": {
    "ims-mcp": {
      "command": "npx",
      "args": ["-y", "ims-mcp-client"],
      "env": {
        "IMS_API_URL": "https://ims.wattslabs.dev",
        "IMS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Step 3: Restart Claude Desktop

That's it! The MCP server will automatically download and run when Claude needs it.

Configuration

Environment Variables

• IMS_API_URL - API endpoint (default: https://ims.wattslabs.dev)
• IMS_API_KEY - Your API key for authentication (required if auth is enabled)

Getting an API Key

Contact your system administrator to get an API key.

Usage

Once configured, just talk to Claude naturally:

"Search my podcast for leadership moments"

"Find clips about innovation suitable for Instagram"

"Compare the raw and final transcripts for Episode 42"

"List all episodes with healthcare guests"

Claude will automatically use the IMS-MCP tools when appropriate.

Available Tools

query_transcripts

Search transcripts using natural language queries.

Example:

"Find moments about overcoming challenges from recent episodes"

get_episode

Retrieve complete episode content by ID or UUID.

Example:

"Get the full transcript for Episode 48"

compare_transcripts

Compare raw vs final transcripts for voice analysis.

Example:

"Compare the raw and edited versions of Episode 42"

generate_clip_suggestions

Generate social media clip suggestions by theme.

Example:

"Suggest 3 clips about entrepreneurship"

list_episodes

List available episodes with metadata.

Example:

"Show me all published episodes"

Troubleshooting

"API key required" error

Make sure you've set the IMS_API_KEY in your Claude Desktop config.

"Connection refused" error

Check that:

1. The API URL is correct
2. You have network access to the API server
3. The API server is running

MCP server not showing up

1. Check your Claude Desktop config file syntax (valid JSON)
2. Restart Claude Desktop completely
3. Check Claude Desktop logs for errors

Support

For issues or questions:

• Check the API status at https://ims.wattslabs.dev/health
• Contact your system administrator
• Review logs in Claude Desktop

License

MIT