{
  "schemaVersion": "0.2.0",
  "version": "1.0.0",
  "name": "Signal Synth",
  "description": "Quality-ranked scoreboard of learning-focused podcast episodes across 9 categories. Agents use Signal Synth to surface the highest-signal podcast content for a given topic or domain, with scored dimensions for filtering and citation-safe episode references.",
  "url": "https://signalsynth.xyz",
  "provider": {
    "organization": "Signal Synth",
    "url": "https://signalsynth.xyz"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": ["text"],
  "defaultOutputModes": ["application/json", "text/markdown", "text/html"],
  "supportedInterfaces": [
    {
      "protocol": "http",
      "transport": "https",
      "url": "https://signalsynth.xyz/api/v1",
      "description": "Public REST endpoints documented at https://signalsynth.xyz/openapi.json. No auth required for read-only endpoints."
    },
    {
      "protocol": "mcp",
      "transport": "https",
      "url": "https://signalsynth.xyz/.well-known/mcp.json",
      "description": "Model Context Protocol server card listing callable tools (get_top_episodes, get_episode)."
    }
  ],
  "skills": [
    {
      "id": "rank-episodes",
      "name": "Rank podcast episodes by signal",
      "description": "Given a category (or 'all'), return the highest-signal episodes scored on six dimensions — originality, actionability, information density, recency, technical depth, clarity.",
      "tags": ["podcasts", "ranking", "recommendation", "curation"],
      "examples": [
        "what's the top tech podcast episode this week?",
        "top 5 finance episodes with signal over 85",
        "highest-signal health episode in the last 7 days"
      ],
      "inputModes": ["text"],
      "outputModes": ["application/json"]
    },
    {
      "id": "cite-episode",
      "name": "Cite a specific episode",
      "description": "Return citation-ready metadata, score breakdown, summary, and optional transcript text for a specific episode identifier.",
      "tags": ["citation", "podcasts", "transcripts"],
      "examples": [
        "quote from the a16z episode on AI parenting",
        "transcript excerpt discussing 'scaling plateau'",
        "full metadata for ep_a16z_777e59cf059a"
      ],
      "inputModes": ["text"],
      "outputModes": ["application/json", "text/html"]
    },
    {
      "id": "browse-weekly",
      "name": "Browse frozen weekly rankings",
      "description": "Return a frozen weekly ranking snapshot for a given ISO week + category. Stable identifiers safe to cite.",
      "tags": ["archive", "history", "weekly"],
      "examples": [
        "top 10 episodes in 2026-W15 finance",
        "archive for week of April 13 2026 tech"
      ],
      "inputModes": ["text"],
      "outputModes": ["application/json", "text/html"]
    }
  ],
  "authentication": {
    "schemes": ["none"],
    "note": "Public endpoints require no auth. Per-user endpoints (episode status, scoring preferences) use WorkOS AuthKit session cookies."
  },
  "contact": "https://github.com/jarvisclaudenelson/signalsynth/issues",
  "documentationUrl": "https://signalsynth.xyz/mcp",
  "associatedProtocols": {
    "mcp": "https://signalsynth.xyz/.well-known/mcp.json",
    "openapi": "https://signalsynth.xyz/openapi.json",
    "agentSkills": "https://signalsynth.xyz/.well-known/agent-skills/index.json"
  }
}