Particle Podcast Intelligence

npx add-mcp 'https://mcp.particle.pro'

Servidor MCP de Particle Pro

Un servidor MCP protegido con OAuth que expone las superficies de podcasts, grafo de conocimiento, empresas y publicidad de Particle como llamadas de herramientas para agentes de IA.

El servidor MCP de Particle Pro se encuentra en https://mcp.particle.pro y permite que agentes de IA — Claude Code, Claude Desktop, Cursor, ChatGPT y cualquier otro cliente compatible con MCP — llamen directamente a las herramientas de podcasts, grafo de conocimiento, empresas y publicidad de Particle. La configuración es una aprobación única en el navegador; todo lo demás lo automatiza el agente.

Conecta tu agente

Instalación en un clic: Añadir a Cursor · Añadir a VS Code — o usa la configuración manual correspondiente a continuación.

```bash Claude Code theme={"dark"} claude mcp add --transport http particle https://mcp.particle.pro ```

// ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
// %APPDATA%\Claude\claude_desktop_config.json (Windows)
//
// Claude Desktop's claude_desktop_config.json doesn't accept a bare `url`.
// Bridge the remote server through `mcp-remote`, which opens a browser
// for OAuth and proxies stdio ↔ Streamable HTTP. Restart Claude Desktop
// after editing.
{
  "mcpServers": {
    "particle": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.particle.pro"]
    }
  }
}

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "particle": {
      "url": "https://mcp.particle.pro"
    }
  }
}

// .vscode/mcp.json
{
  "servers": {
    "particle": {
      "type": "http",
      "url": "https://mcp.particle.pro"
    }
  }
}

# Bridges a stdio MCP client to a remote OAuth-secured Streamable HTTP server.
npx -y mcp-remote https://mcp.particle.pro

Nota

Alternativa de interfaz de Claude Desktop: Configuración → Conectores → Añadir conector personalizado, pega https://mcp.particle.pro, completa OAuth en el navegador. Es más fácil que editar JSON y evita el puente mcp-remote.

Nota

ChatGPT: Configuración → Seguridad e inicio de sesión → activa Modo desarrollador (disponible para cuentas Pro, Plus, Business, Enterprise y Edu en la web) → chatgpt.com/plugins → + → pega https://mcp.particle.pro como URL del servidor con OAuth y completa la aprobación en el navegador. Consulta la Guía de inicio rápido para el flujo paso a paso.

Cualquier otro cliente MCP: apúntalo a https://mcp.particle.pro a través de Streamable HTTP y prefiere OAuth si el cliente lo admite; los clientes solo-stdio pueden conectarse mediante mcp-remote (última pestaña arriba).

Que un agente lo haga por ti: pega Read https://api.particle.pro/agents.md and connect me to Particle. en cualquier agente de codificación. El playbook cubre cada cliente mencionado, el reinicio que la mayoría de los clientes necesitan antes de que aparezcan nuevas herramientas, y una primera consulta en vivo.

La primera llamada a una herramienta activa un flujo OAuth: tu cliente abre la URL de autorización en un navegador, inicias sesión en Particle Pro y eliges el proyecto en el que el agente debe actuar, y tu cliente intercambia el código resultante por un token automáticamente. Consulta la Guía de inicio rápido para un recorrido paso a paso y una llamada de verificación, o Autenticación para la especificación completa de OAuth 2.1.

Qué incluye

40 herramientas, organizadas en categorías de exposición. Una conexión básica anuncia las siete categorías predeterminadas más las meta-herramientas siempre activas system; seis categorías adicionales, incluidas las tarjetas Radar, son opt-in (se anuncian solo cuando las seleccionas con el selector ?include=). En cualquier caso, toda herramienta pública se puede invocar por nombre independientemente de lo anunciado — consulta Conjuntos de herramientas y descubrimiento.

Categorías predeterminadas: resuelven podcasts/personas/empresas, buscan transcripciones, listan episodios, extraen menciones, exploran temas, clasifican rankings e invitados. Categorías opt-in: analíticas de patrocinadores, perfiles de editores, valoraciones de oyentes y vistas de sesgo/adecuación de marca en todo el corpus. `particle_catalog` y `particle_call` — siempre activas, para que un agente predeterminado pueda descubrir y llamar al resto de la superficie. La mecánica del selector y el contrato de que el descubrimiento es gratuito mientras la ejecución se mide.

Endpoint	https://mcp.particle.pro
Transporte	Streamable HTTP
Autenticación	OAuth 2.1 (clientes interactivos) o claves de API de plataforma (agentes headless) — consulta Autenticación
Número de herramientas	40 en 14 categorías de exposición (7 predeterminadas + siempre activas system, 6 opt-in)
Nombres de herramientas	Identificadores planos particle_*; toda herramienta pública se puede invocar por nombre
Lectura/escritura	La mayoría de las herramientas son de lectura. particle_alert_create, particle_alert_update y particle_alert_delete cambian el estado del proyecto y anuncian readOnlyHint: false (eliminar también destructiveHint: true); particle_call lleva las mismas advertencias cautelosas porque puede despacharlas

Cómo se componen las herramientas

Las herramientas no son consultas aisladas — exponen un único grafo de conocimiento conectado, y dos convenciones sustentan la mayor parte del diseño:

• Ligero por defecto, expansión bajo demanda. La mayoría de las herramientas devuelven una carga mínima y optan por secciones más ricas mediante un array include (las personas, productos y competidores de una empresa; los roles y apariciones en podcasts de una persona; los segmentos, clips, temas y transcripción de un episodio) o un interruptor mode/format. Una herramienta hace mucho más de lo que su nombre sugiere — revisa su esquema de entrada (o las pistas de expansión ↳ en particle_catalog) antes de asumir que falta una capacidad.
• Los slugs son aristas. Cada slug que devuelve una herramienta — persona, empresa, podcast, episodio, editor, invitado — es una entrada válida para las demás herramientas. Resuelve un nombre de texto libre una vez y luego recorre: particle_company_resolve("Andreessen Horowitz") → particle_company_get con include: ["people"] → particle_person_get con include: ["podcast_appearances"] → particle_podcast_get_episode con include: ["transcript", "entities"]. Cuatro saltos desde un nombre de empresa hasta cada entidad mencionada en un episodio en el que apareció uno de sus socios.

Los clientes conectados reciben la misma guía en banda: las instrucciones initialize del servidor establecen ambas convenciones en cada conexión, y particle_catalog muestra las opciones de expansión de cada herramienta.

Ejemplos de indicaciones

Para comparaciones visuales, la herramienta opcional particle_radar_render_cards muestra una pequeña selección de resultados ya recuperados por las herramientas de datos. El servidor sirve su interfaz estática de MCP Apps a través de resources/read. El renderizado es gratuito; los clientes sin soporte de interfaz reciben la misma evidencia seleccionada y enlaces de fuentes en Markdown.

Después de conectarte, prueba preguntar a tu agente:

• "¿Qué han dicho los presentadores de podcasts sobre los agentes de IA que reemplazan al SaaS en los últimos 90 días?"
• "Encuentra el episodio de All-In donde discutieron sobre Anthropic y resume el segmento."
• "Prepara un informe sobre Ramp: quién la dirige, quién compite con ella y dónde han aparecido sus ejecutivos en podcasts."
• "¿Qué podcasts patrocina Notion y qué dicen los presentadores sobre ella de forma orgánica?"
• "¿Quiénes son los invitados de IA en tendencia este mes y en qué programas han aparecido?"
• "Todo lo dicho sobre Jensen Huang en podcasts este trimestre, organizado por tema."

Las indicaciones sobre una persona, empresa o programa nombrados comienzan con una herramienta de resolución y luego recorren los slugs que devuelve; las indicaciones sobre un tema comienzan con particle_podcast_search_transcripts. Los paquetes de habilidades empaquetan los mismos bucles con las herramientas que necesitan.

En qué se diferencia de la API REST

La API REST y el servidor MCP comparten un único proceso subyacente y los mismos manejadores. Las diferencias:

• Forma. Cada herramienta MCP devuelve un bloque de contenido de texto markdown. Pasa output_format: "json" para recibir la misma respuesta como JSON compacto en ese bloque. Si necesitas JSON tipado con un esquema estable para uso programático, accede al endpoint REST subyacente enlazado desde cada página de herramienta.
• Agrupación. Algunas herramientas MCP combinan múltiples llamadas REST (por ejemplo, particle_podcast_get_episode también puede obtener entidades principales, segmentos, clips, temas y la transcripción mediante su array include). Los endpoints REST son de un solo recurso.
• Identificadores. Las herramientas MCP siempre aceptan el slug orientado al agente (person_slug, company_slug, podcast_slug, episode_slug, publisher_slug). La API REST acepta los mismos slugs junto con IDs canónicos codificados.
• Autenticación. Los clientes MCP interactivos usan tokens de acceso OAuth 2.1 vinculados a https://mcp.particle.pro como su claim aud; los agentes headless pueden enviar las mismas claves de API pp_* que acepta la API REST. Consulta Autenticación.
• Errores. Las herramientas MCP muestran errores como resultados isError: true con un mensaje legible en lugar de cuerpos de problem-details HTTP. Consulta Errores.

Cuándo usar cada superficie

• ¿Estás construyendo un agente (Claude Code, Cursor, Claude Desktop, cliente MCP personalizado)? Usa el servidor MCP. Las respuestas de herramientas agrupadas, las entradas basadas en slugs y el renderizado en markdown están diseñados para bucles de agente.
• ¿Estás construyendo un servicio (servidor a servidor, trabajo programado o el backend detrás de tu frontend — las claves de API deben permanecer en el servidor)? Usa la API REST. Control fino, esquema OpenAPI, cargas predecibles.
• Ambas superficies hablan con la misma base de datos, el mismo ranking de búsqueda y el mismo medidor de facturación, por lo que mezclarlas dentro de una organización es válido.

Descubrimiento

Los agentes que siguen las especificaciones MCP / OAuth descubren todo lo que necesitan del recurso:

• https://mcp.particle.pro/.well-known/oauth-protected-resource — metadatos de recurso protegido RFC 9728 que apuntan al AS.
• Un 401 del endpoint MCP lleva WWW-Authenticate: Bearer realm="mcp", error="...", resource_metadata="..." para que los clientes no autenticados puedan iniciar el arranque.

El documento de metadatos del Servidor de Autorización en https://api.particle.pro/.well-known/oauth-authorization-server contiene el resto (endpoint de tokens, endpoint de registro, scopes admitidos, URI de JWKS).

Próximos pasos

Configuración paso a paso con solución de problemas para cada cliente. OAuth 2.1 de extremo a extremo: descubrimiento, registro, PKCE, renovación, revocación. Cada herramienta, cada entrada, cada salida. Categorías de exposición, selectores de inclusión/exclusión y el contrato de invocación siempre disponible. Cómo se muestran los errores de las herramientas y cómo deben reaccionar los agentes.