Particle Podcast Intelligence

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

Servidor MCP Particle Pro

Um servidor MCP protegido por OAuth que expõe as superfícies de podcast, grafo de conhecimento, empresas e publicidade da Particle como chamadas de ferramenta para agentes de IA.

O servidor MCP Particle Pro está em https://mcp.particle.pro e permite que agentes de IA — Claude Code, Claude Desktop, Cursor, ChatGPT e qualquer outro cliente compatível com MCP — chamem diretamente as ferramentas de podcast, grafo de conhecimento, empresas e publicidade da Particle. A configuração é uma única aprovação no navegador; todo o resto é automatizado pelo agente.

Conecte seu agente

Instalação em um clique: Adicionar ao Cursor · Adicionar ao VS Code — ou use a configuração manual correspondente abaixo.

```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 pela interface do Claude Desktop: Configurações → Conectores → Adicionar conector personalizado, cole https://mcp.particle.pro, conclua o OAuth no navegador. É mais fácil do que editar JSON e evita a ponte mcp-remote.

Nota

ChatGPT: Configurações → Segurança e login → ative o Modo desenvolvedor (disponível para contas Pro, Plus, Business, Enterprise e Edu na web) → chatgpt.com/plugins → + → cole https://mcp.particle.pro como URL do servidor com OAuth e conclua a aprovação no navegador. Consulte o Quickstart para o fluxo passo a passo.

Qualquer outro cliente MCP: aponte-o para https://mcp.particle.pro via Streamable HTTP e prefira OAuth se o cliente suportar; clientes somente stdio podem fazer a ponte por meio de mcp-remote (última aba acima).

Peça a um agente para fazer isso: cole Read https://api.particle.pro/agents.md and connect me to Particle. em qualquer agente de codificação. O playbook cobre todos os clientes acima, a reinicialização que a maioria dos clientes precisa antes que novas ferramentas apareçam e uma primeira consulta ao vivo.

A primeira chamada de ferramenta aciona um fluxo OAuth: seu cliente abre a URL de autorização no navegador, você faz login no Particle Pro e escolhe o projeto em que o agente deve atuar, e seu cliente troca o código resultante por um token automaticamente. Consulte o Quickstart para um passo a passo detalhado e uma chamada de verificação, ou Autenticação para a especificação completa do OAuth 2.1.

O que está incluído

40 ferramentas, organizadas em categorias de exposição. Uma conexão básica anuncia as sete categorias padrão mais as meta-ferramentas sempre ativas system; seis categorias adicionais, incluindo cartões Radar, são opt-in (anunciadas somente quando você as seleciona com o seletor ?include=). De qualquer forma, toda ferramenta pública pode ser chamada pelo nome, independentemente do que foi anunciado — consulte Conjuntos de ferramentas e descoberta.

Categorias padrão — resolvem podcasts/pessoas/empresas, pesquisam transcrições, listam episódios, buscam menções, navegam por tópicos, classificam rankings e convidados. Categorias opt-in — análises de patrocinadores, perfis de editores, avaliações de ouvintes e visões de viés/adequação de marca em todo o corpus. `particle_catalog` e `particle_call` — sempre ativas, para que um agente padrão possa descobrir e chamar o restante da superfície. A mecânica do seletor e o contrato de que a descoberta é gratuita enquanto a execução é medida.

Endpoint	https://mcp.particle.pro
Transporte	Streamable HTTP
Autenticação	OAuth 2.1 (clientes interativos) ou chaves de API da plataforma (agentes headless) — consulte Autenticação
Número de ferramentas	40 em 14 categorias de exposição (7 padrão + sempre ativas system, 6 opt-in)
Nomes das ferramentas	Identificadores particle_* simples; toda ferramenta pública pode ser chamada pelo nome
Leitura/escrita	A maioria das ferramentas lê. particle_alert_create, particle_alert_update e particle_alert_delete alteram o estado do projeto e anunciam readOnlyHint: false (delete também destructiveHint: true); particle_call carrega as mesmas dicas cautelosas porque pode despachá-las

Como as ferramentas se compõem

As ferramentas não são consultas isoladas — elas expõem um único grafo de conhecimento conectado, e duas convenções carregam a maior parte do design:

• Enxuto por padrão, expanda sob demanda. A maioria das ferramentas retorna um payload mínimo e opta por seções mais ricas via um array include (pessoas, produtos e concorrentes de uma empresa; papéis e aparições em podcasts de uma pessoa; segmentos, clipes, tópicos e transcrição de um episódio) ou um switch mode/format. Uma ferramenta faz muito mais do que seu nome sugere — verifique seu esquema de entrada (ou as dicas de expansão ↳ em particle_catalog) antes de assumir que um recurso está ausente.
• Slugs são arestas. Todo slug que uma ferramenta retorna — pessoa, empresa, podcast, episódio, editor, convidado — é uma entrada válida para as outras ferramentas. Resolva um nome em texto livre uma vez e depois percorra: particle_company_resolve("Andreessen Horowitz") → particle_company_get com include: ["people"] → particle_person_get com include: ["podcast_appearances"] → particle_podcast_get_episode com include: ["transcript", "entities"]. Quatro saltos de um nome de empresa para cada entidade discutida em um episódio em que um de seus parceiros apareceu.

Clientes conectados recebem a mesma orientação em banda: as instruções initialize do servidor declaram ambas as convenções em cada conexão, e particle_catalog expõe as opções de expansão de cada ferramenta.

Exemplos de prompts

Para comparações visuais, a ferramenta opcional particle_radar_render_cards exibe uma pequena seleção de resultados já recuperados pelas ferramentas de dados. O servidor serve sua interface estática de aplicativos MCP por meio de resources/read. A renderização é gratuita; clientes sem suporte a interface recebem as mesmas evidências selecionadas e links de origem em Markdown.

Após conectar, tente perguntar ao seu agente:

• "O que os apresentadores de podcasts disseram sobre agentes de IA substituindo SaaS nos últimos 90 dias?"
• "Encontre o episódio do All-In em que discutiram a Anthropic e resuma o segmento."
• "Monte um briefing sobre a Ramp: quem a dirige, quem compete com ela e onde seus executivos apareceram em podcasts."
• "Quais podcasts a Notion patrocina e o que os apresentadores dizem sobre ela organicamente?"
• "Quem são os convidados de IA em alta este mês e quais programas os receberam?"
• "Tudo o que foi dito sobre Jensen Huang em podcasts neste trimestre, organizado por tema."

Prompts sobre uma pessoa, empresa ou programa nomeados começam com uma ferramenta de resolução e depois percorrem os slugs que ela retorna; prompts sobre um tópico começam com particle_podcast_search_transcripts. Os pacotes de habilidades empacotam os mesmos loops com as ferramentas de que precisam.

Como difere da API REST

A API REST e o servidor MCP compartilham um único processo de suporte e os mesmos manipuladores. As diferenças:

• Forma. Cada ferramenta MCP retorna um bloco de conteúdo de texto em markdown. Passe output_format: "json" para receber a mesma resposta como JSON compacto nesse bloco. Se você precisar de JSON tipado com um esquema estável para uso programático, acesse o endpoint REST subjacente vinculado a cada página de ferramenta.
• Agrupamento. Algumas ferramentas MCP agrupam várias chamadas REST (por exemplo, particle_podcast_get_episode também pode buscar entidades principais, segmentos, clipes, tópicos e a transcrição por meio de seu array include). Os endpoints REST são de recurso único.
• Identificadores. As ferramentas MCP sempre aceitam o slug voltado ao agente (person_slug, company_slug, podcast_slug, episode_slug, publisher_slug). A API REST aceita os mesmos slugs junto com IDs canônicos codificados.
• Autenticação. Clientes MCP interativos usam tokens de acesso OAuth 2.1 vinculados a https://mcp.particle.pro como sua declaração aud; agentes headless podem enviar as mesmas chaves de API pp_* que a API REST aceita. Consulte Autenticação.
• Erros. As ferramentas MCP exibem erros como resultados isError: true com uma mensagem legível por humanos em vez de corpos de detalhes de problema HTTP. Consulte Erros.

Quando usar cada superfície

• Construindo um agente (Claude Code, Cursor, Claude Desktop, cliente MCP personalizado)? Use o servidor MCP. As respostas de ferramenta agrupadas, entradas baseadas em slug e renderização em markdown são projetadas para loops de agente.
• Construindo um serviço (servidor para servidor, trabalho agendado ou o backend por trás do seu frontend — as chaves de API devem permanecer no lado do servidor)? Use a API REST. Controle refinado, esquema OpenAPI, payloads previsíveis.
• Ambas as superfícies falam com o mesmo banco de dados, a mesma classificação de busca e o mesmo medidor de cobrança, então misturá-las dentro de uma organização é aceitável.

Descoberta

Agentes que seguem as especificações MCP / OAuth descobrem tudo o que precisam do recurso:

• https://mcp.particle.pro/.well-known/oauth-protected-resource — metadados de recurso protegido RFC 9728 apontando para o AS.
• Um 401 do endpoint MCP carrega WWW-Authenticate: Bearer realm="mcp", error="...", resource_metadata="..." para que clientes não autenticados possam inicializar.

O documento de metadados do Authorization Server em https://api.particle.pro/.well-known/oauth-authorization-server carrega o restante (endpoint de token, endpoint de registro, escopos suportados, URI JWKS).

Próximos passos

Configuração passo a passo com solução de problemas para cada cliente. OAuth 2.1 de ponta a ponta: descoberta, registro, PKCE, atualização, revogação. Toda ferramenta, toda entrada, toda saída. Categorias de exposição, seletores de inclusão/exclusão e o contrato de sempre chamável. Como os erros de ferramenta aparecem e como os agentes devem reagir.