Menu
Sign In Search Podcasts Libraries Charts People & Topics Add Podcast API Blog Pricing

Model Context Protocol (MCP) Documentation

Audioscrape provides a Model Context Protocol (MCP) server that allows AI assistants like Claude to directly access and search audio content. This enables AI models to provide contextual information from millions of hours of spoken content in real-time.

While we currently index over 1M hours of podcasts and conversations, we're expanding to include meetings, calls, interviews, live streams, and more audio sources.

Getting Started

The Audioscrape MCP server is available at mcp.audioscrape.com.

Our MCP implementation supports OAuth 2.1 authentication with mandatory PKCE, dynamic client registration, and resource indicators, following the MCP Authorization spec (Nov 2025).

Pick Your Client

Step-by-step setup guides for the most common MCP clients:

ChatGPT

Requires Plus, Pro, Team, Enterprise, or Edu with Developer Mode enabled. A few minutes to set up.

Claude Desktop

Claude Pro, Max, Team, or Enterprise. Under 30 seconds — just paste the URL.

Claude Code

One-line command in your terminal. Best for CLI / coding workflows.

Cursor

All plans including free. Paste a 5-line config into mcp.json.

Using a different MCP-compatible client? Point it at https://mcp.audioscrape.com — OAuth is handled automatically.

Available Tools

All tools have readOnlyHint: true - they only read data and never modify anything.

search_audio_content

Search across all indexed audio content including podcasts, interviews, and talks. Find discussions on any topic with speaker identification and timestamps.

Parameters

{
  "query": {
    "type": "string",
    "description": "Search query text",
    "required": true
  },
  "search_type": {
    "type": "string",
    "enum": ["text", "semantic"],
    "default": "text",
    "description": "Type of search: 'text' for keyword matching, 'semantic' for conceptual search"
  },
  "limit": {
    "type": "integer",
    "default": 50,
    "minimum": 1,
    "maximum": 200,
    "description": "Maximum number of results"
  },
  "offset": {
    "type": "integer",
    "default": 0,
    "description": "Offset for pagination"
  },
  "sort_by": {
    "type": "string",
    "enum": ["relevance", "date", "episode_title"],
    "default": "relevance"
  },
  "sort_order": {
    "type": "string",
    "enum": ["asc", "desc"],
    "default": "desc"
  },
  "filters": {
    "type": "object",
    "properties": {
      "podcast_ids": {"type": "array", "items": {"type": "string"}},
      "date_from": {"type": "string", "description": "YYYY-MM-DD"},
      "date_to": {"type": "string", "description": "YYYY-MM-DD"},
      "recency": {"type": "string", "enum": ["last_week", "last_month", "last_year"]}
    }
  },
  "include_context": {
    "type": "boolean",
    "default": false,
    "description": "Include surrounding segments for context"
  }
}

Example Request

{
  "query": "artificial intelligence ethics",
  "search_type": "semantic",
  "limit": 10,
  "filters": {
    "recency": "last_month"
  }
}

Example Response

{
  "results": [
    {
      "episode_id": "12345",
      "episode_title": "The Future of AI Ethics",
      "podcast_title": "Tech Talk Daily",
      "segment_text": "The ethics of artificial intelligence is...",
      "timestamp": "00:15:32",
      "speaker": "Dr. Jane Smith",
      "url": "https://www.audioscrape.com/episode/tech-talk/ai-ethics#t=932",
      "relevance_score": 0.95
    }
  ],
  "total_results": 247,
  "has_more": true
}

list_recent_episodes

List recent podcast episodes with optional filtering by podcast or time period.

Parameters

{
  "limit": {
    "type": "integer",
    "default": 20,
    "minimum": 1,
    "maximum": 100,
    "description": "Maximum number of episodes"
  },
  "podcast_ids": {
    "type": "array",
    "items": {"type": "string"},
    "description": "Filter by specific podcast IDs"
  },
  "days_back": {
    "type": "integer",
    "default": 7,
    "minimum": 1,
    "maximum": 365,
    "description": "Number of days to look back"
  }
}

Example Request

{
  "limit": 10,
  "days_back": 3
}

Example Response

{
  "episodes": [
    {
      "id": "12345",
      "title": "Latest Tech News Roundup",
      "podcast_title": "Tech Talk Daily",
      "publish_date": "2024-12-15",
      "duration_seconds": 3600,
      "url": "https://www.audioscrape.com/episode/tech-talk/news-roundup"
    }
  ],
  "total": 10
}

get_episode_content

Get full content and metadata for a specific episode, including transcript and speaker information.

Parameters

{
  "episode_id": {
    "type": "string",
    "required": true,
    "description": "Episode ID to retrieve"
  },
  "include_segments": {
    "type": "boolean",
    "default": true,
    "description": "Include full transcript segments"
  },
  "include_metadata": {
    "type": "boolean",
    "default": true,
    "description": "Include metadata (speakers, entities)"
  }
}

Example Request

{
  "episode_id": "12345",
  "include_segments": true,
  "include_metadata": true
}

Example Response

{
  "episode": {
    "id": "12345",
    "title": "The Future of AI Ethics",
    "podcast_title": "Tech Talk Daily",
    "publish_date": "2024-12-15",
    "duration_seconds": 3600,
    "description": "A deep dive into AI ethics..."
  },
  "segments": [
    {
      "start_time": "00:00:00",
      "end_time": "00:02:30",
      "text": "Welcome to Tech Talk Daily...",
      "speaker": "Host"
    },
    {
      "start_time": "00:02:30",
      "end_time": "00:05:00",
      "text": "Thank you for having me...",
      "speaker": "Dr. Jane Smith"
    }
  ],
  "speakers": ["Host", "Dr. Jane Smith"],
  "entities": [
    {"name": "Artificial Intelligence", "type": "technology"},
    {"name": "OpenAI", "type": "organization"}
  ]
}

browse_podcast

Browse episodes from a specific podcast series.

Parameters

{
  "podcast_id": {
    "type": "string",
    "required": true,
    "description": "Podcast ID to browse"
  },
  "limit": {
    "type": "integer",
    "default": 50,
    "minimum": 1,
    "maximum": 200
  },
  "offset": {
    "type": "integer",
    "default": 0
  },
  "sort_by": {
    "type": "string",
    "enum": ["date", "title"],
    "default": "date"
  }
}

Example Request

{
  "podcast_id": "tech-talk-daily",
  "limit": 20,
  "sort_by": "date"
}

Example Response

{
  "podcast": {
    "id": "tech-talk-daily",
    "title": "Tech Talk Daily",
    "publisher": "Tech Media Inc",
    "description": "Daily tech news and interviews"
  },
  "episodes": [
    {
      "id": "12345",
      "title": "Latest Tech News",
      "publish_date": "2024-12-15",
      "duration_seconds": 3600
    }
  ],
  "total_episodes": 250,
  "has_more": true
}

Authentication

The Audioscrape MCP server uses OAuth 2.1 with mandatory PKCE (S256) for secure authentication. Spec-compliant MCP clients handle this automatically. For custom integrations, follow this flow:

Authorization Flow:

  1. Discover — GET /.well-known/oauth-authorization-server
  2. Register — POST /oauth/register with client_name and redirect_uris (RFC 7591)
  3. Authorize — GET /oauth/authorize with code_challenge (S256) and optional resource parameter (RFC 8707)
  4. Exchange — POST /oauth/token with code and code_verifier
  5. Refresh — POST /oauth/token with grant_type=refresh_token (tokens are rotated)

Discovery Endpoints:

  • /.well-known/oauth-authorization-server — Authorization server metadata (RFC 8414)
  • /.well-known/openid-configuration — Same metadata, OpenID Connect compatible
  • /.well-known/oauth-protected-resource — Protected resource metadata (RFC 9728)

Example: Register a Client

POST https://mcp.audioscrape.com/oauth/register
Content-Type: application/json

{
  "client_name": "My AI App",
  "redirect_uris": ["https://myapp.com/callback"],
  "grant_types": ["authorization_code", "refresh_token"],
  "response_types": ["code"],
  "scope": "mcp:search mcp:read profile"
}

Manage connected apps from your profile settings.

Rate Limits

To ensure fair usage and system stability, the following rate limits apply:

  • • Search requests: 100 per minute
  • • Episode/transcript requests: 200 per minute
  • • List operations: 50 per minute

Example Prompts

Example queries you can ask Claude when connected:

  • • "Find recent discussions about artificial intelligence ethics"
  • • "Search for mentions of OpenAI in the last month"
  • • "What are podcasters saying about the latest tech trends?"
  • • "Get the full transcript of episode ID 12345"
  • • "List the latest episodes from Lex Fridman Podcast"

Troubleshooting

Authentication Failed

Make sure you're logged into your Audioscrape account in your browser. The OAuth flow will open a browser window for authentication.

Connection Timeout

Check your internet connection and firewall settings. The MCP server runs on port 443 (HTTPS).

No Results Found

Try broader search terms or use semantic search for conceptual queries. Not all podcasts are indexed yet.

Support

For technical support or questions about the MCP integration, please contact us at [email protected].

Previous
Notifications API
Next
ChatGPT