Taddy API Skill, MCP Server, and Docs

We have 3 AI tools / resources to help you get the most out of Taddy Podcast API

Taddy API Skill - We recommend using our open-source skill when you add Taddy Podcast API to your application. It gives your AI coding tool (Claude Code, Codex, Cursor etc.) our full API docs in Markdown, our GraphQL schema, and best practices for things like pagination and error handling.

MCP Server for Taddy API – Use Taddy API’s MCP server if you want to get podcast data (including transcripts) inside ChatGPT, Claude, or any MCP-compatible app. ex) You can ask to "Find recent episodes that mention [my company] and summarize the positive and negative feedback".

Taddy API Docs - If you just want to provide to your AI coding tool our API docs & GraphQL schema. It's the building blocks we used to make the Taddy API Skill.

1. Adding Taddy API’s Skill to your project

Ask your AI agent to: Download the Taddy API skill from https://github.com/taddyorg/taddy-api-skills into your project's skills folder.

2. Adding Taddy API’s MCP server to your project

Taddy API’s MCP Server is available at: https://taddy.org/mcp/podcast-api

You will need your Taddy API User ID and API Key, you can get them at: https://taddy.org/dashboard

Adding MCP Server to Claude Desktop or claude.ai

Follow these steps:

Open Claude and click on Settings → Customize → Add → Add Custom Connector

Add link to the MCP Server: https://taddy.org/mcp/podcast-api

Add Headers x-account-id and x-api-key. You will find these value on the Taddy Dashboard.

Note: Taddy API normally uses x-user-id, but Claude only supports a limited set of custom headers by default, and x-user-id isn’t one of them. Use x-account-id instead. We’ll map it to x-user-id automatically.

Adding MCP Server to ChatGPT Desktop

Follow these steps:

Open ChatGPT, and click on Settings → Plugins → Add → Add MCP Server

Add link to the MCP Server: https://taddy.org/mcp/podcast-api

Add Headers x-user-id and x-api-key. You will find these value on the Taddy Dashboard.

Adding MCP Server to Claude Code or Codex

For Claude Code, add or append to .mcp.json


{
  "mcpServers": {
    "taddy-podcast-api": {
      "type": "http",
      "url": "https://taddy.org/mcp/podcast-api",
      "headers": {
        "X-USER-ID": "${TADDY_USER_ID}",
        "X-API-KEY": "${TADDY_API_KEY}"
      }
    }
  }
}

For Codex, add or append to ~/.codex/config.toml


[mcp_servers.taddy-podcast-api]
url = "https://taddy.org/mcp/podcast-api"
env_http_headers = { "X-USER-ID" = "TADDY_USER_ID", "X-API-KEY" = "TADDY_API_KEY" }

And set these credentials in the environment:


export TADDY_USER_ID="<user id>"
export TADDY_API_KEY="<api key>"

3. Taddy API Docs

Here are two resources that you can provide your AI coding tool to give it useful context about our API, we used this as input for the Taddy API Skill:

GraphQL Schema - The complete Podcast API GraphQL schema with all available types, queries, and mutations available.

Taddy API Documentation - The full documentation for Taddy Podcast API in one big markdown file.