Perigon MCP Server

Servidor MCP oficial para a API Perigon, fornecendo acesso a dados de notícias e mídia em tempo real.

GitHub

Experimente este MCPPatrocinado

Documentação

Perigon logo

Perigon MCP Server

Este é o servidor MCP oficial para a API de notícias da Perigon.

Documentação

Para mais informações sobre como usar e conectar o MCP, visite a documentação do MCP.

Mantenedores

O Perigon MCP Server é desenvolvido e mantido pela equipe de engenharia da Perigon.

Desenvolvedor líder: Islem Maboud, responsável pela arquitetura, implementação e desenvolvimento contínuo deste servidor MCP, incluindo a camada de transporte remoto, tratamento de autenticação, configuração de implantação e o playground do MCP.

Uso

Playground

Você pode experimentar o servidor MCP da Perigon em nosso playground.

Nota: Uma chave de API Perigon válida é necessária para usar o MCP. O playground do MCP exige que você já esteja autenticado no painel da Perigon.

Conexão

Você pode se conectar ao nosso servidor MCP remoto usando qualquer cliente compatível com MCP.

URL do servidor: https://mcp.perigon.io

O transporte recomendado é Streamable HTTP (/v1/mcp). SSE (/v1/sse) é suportado para clientes legados, mas não é recomendado para novas integrações.

Exemplos de Configuração Rápida

Streamable HTTP — suporte nativo (recomendado):

{
  "mcpServers": {
    "perigon_news_api": {
      "url": "https://mcp.perigon.io/v1/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_PERIGON_API_KEY"
      }
    }
  }
}

Streamable HTTP — via mcp-remote (para clientes sem suporte HTTP nativo):

{
  "mcpServers": {
    "perigon_news_api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.perigon.io/v1/mcp",
        "--header",
        "Authorization: Bearer ${PERIGON_API_KEY}"
      ],
      "env": {
        "PERIGON_API_KEY": "YOUR_PERIGON_API_KEY"
      }
    }
  }
}

Para Claude Code (CLI):

claude mcp add --transport http perigon_news_api https://mcp.perigon.io/v1/mcp \
  --header "Authorization: Bearer YOUR_PERIGON_API_KEY"

SSE (somente clientes legados):

{
  "mcpServers": {
    "perigon_news_api": {
      "url": "https://mcp.perigon.io/v1/sse",
      "type": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_PERIGON_API_KEY"
      }
    }
  }
}

📖 Para instruções detalhadas de configuração para diferentes clientes, consulte nossa documentação abrangente do MCP.

Selecionando ferramentas específicas

Por padrão, todas as ferramentas permitidas pela sua chave de API estão disponíveis. Você pode restringir uma sessão a um conjunto menor anexando um parâmetro de consulta ?tools= à URL do servidor. Isso é útil para reduzir o tamanho do contexto e manter o modelo focado.

https://mcp.perigon.io/v1/mcp?tools=search_news_articles,search_news_stories

Passe uma lista separada por vírgulas de nomes de ferramentas, ou all para ativar explicitamente todas as ferramentas permitidas.
Somente ferramentas às quais sua chave de API já tem acesso serão ativadas — o parâmetro não pode expandir permissões.
Omitir o parâmetro, passar um valor vazio ou passar all são todos equivalentes e ativam todas as ferramentas permitidas.

Exemplo — configuração do Cursor limitada à busca de artigos e histórias:

{
  "mcpServers": {
    "perigon_news_api": {
      "url": "https://mcp.perigon.io/v1/mcp?tools=search_news_articles,search_news_stories",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_PERIGON_API_KEY"
      }
    }
  }
}

Perfis de ferramentas nomeados

Em vez de listar nomes de ferramentas individuais, ?tools= também aceita aliases de perfis selecionados — uma abreviação útil para reduzir o contexto a um subconjunto adequado à tarefa:

Perfil	Inclui
`research`	Ferramentas principais de busca, estatísticas e consulta para pesquisa de notícias (artigos, histórias, jornalistas, fontes, pessoas, empresas, tópicos, estatísticas, `get_source_by_id`, `get_api_access`).
`monitoring`	Todas as ferramentas de monitor (incluindo `create_monitor`/`update_monitor`) mais todas as ferramentas do Signal Insights.
`platform`	Listas de acompanhamento, grupos de fontes, pontos de contato, status de atualização de artigos e `get_api_access`.
`minimal`	`search_news_articles` mais as cinco ferramentas de estatísticas e `get_api_access` — o menor conjunto de pesquisa útil.

Os perfis podem ser combinados com nomes de ferramentas explícitos no mesmo valor de ?tools= (por exemplo, ?tools=research,create_monitor), e são sempre interseccionados com o que os escopos da sua chave de API realmente permitem.

Exemplos de Prompts

Ao dar instruções ao seu agente, recomendamos fornecer a data atual (ou uma ferramenta para obtê-la), a menos que o agente já tenha acesso a essas informações, pois alguns modelos como o Claude, caso contrário, pensarão que a data atual é o corte de conhecimento deles e recuperarão informações desatualizadas com frequência.

Artigos e Histórias de Notícias:

Me dê as 5 principais manchetes políticas nos Estados Unidos de hoje.
Quais histórias de negócios estão em alta em Nova York hoje?
Mostre-me as últimas notícias de tecnologia da Califórnia esta semana.
Encontre notícias políticas de estados decisivos nos últimos 3 dias.
Mostre-me histórias relacionadas a criptomoedas da última semana.

Jornalistas e Fontes:

Encontre fontes de notícias locais no Texas.
Quem são os principais jornalistas de negócios em grandes publicações?
Encontre jornalistas que cobrem energia renovável e depois mostre-me seus artigos recentes.
Quais jornalistas escrevem mais sobre política climática?
Mostre-me artigos de grandes publicações financeiras hoje.

Pessoas e Empresas:

Encontre notícias recentes sobre CEOs de empresas farmacêuticas.
Pesquise a Tesla como empresa e depois encontre notícias recentes sobre ela.
Mostre-me empresas do setor de veículos elétricos.
Pesquise políticos mencionados em histórias de saúde.
O que as empresas de tecnologia estão dizendo sobre a regulamentação de IA?

Monitores:

Liste meus monitores de eventos ativos.
Mostre-me os eventos mais recentes detectados pelo meu monitor de recall de produtos.
Crie um rascunho de monitor para saídas de executivos no setor de semicondutores.
Pause meu monitor de menções a concorrentes.
Mostre-me o boletim mais recente do meu monitor de tópicos de regulamentação de IA.

Ferramentas suportadas

A lista completa de ferramentas disponíveis — incluindo nomes, descrições e esquemas de parâmetros — está visível no playground do MCP. As ferramentas disponíveis para você dependem dos escopos concedidos à sua chave de API.

Ferramentas de estatísticas

As cinco ferramentas de estatísticas estão sempre disponíveis independentemente do escopo — os endpoints /v1/stats/* subjacentes não realizam verificação de permissão além de uma chave válida — e fornecem métricas agregadas calculadas no servidor, o que geralmente é preferível a contar resultados de busca manualmente.

Ferramenta	Descrição
`get_avg_sentiment`	Sentimento médio (positivo/negativo/neutro) agrupado ao longo do tempo para artigos que correspondem a um conjunto de filtros.
`get_article_counts`	Volume de publicação de artigos agrupado ao longo do tempo — combine com `get_avg_sentiment` em filtros idênticos para uma visão de tendência.
`get_top_entities`	Os tópicos, pessoas, empresas, cidades, jornalistas ou fontes mais mencionados.
`get_top_people`	Pessoas cuja cobertura está em alta em relação a um período de referência.
`get_top_companies`	Empresas cuja cobertura está em alta em relação a um período de referência.

Ferramentas de permissão

Ferramenta	Descrição
`get_api_access`	Sempre disponível. Relata os escopos desta chave, organização, cota de uso e o comportamento de permissão derivado (campos removidos, filtros bloqueados, restrições de janela de data). Chame uma vez por sessão, ou após um 403 ou um campo inesperadamente nulo/vazio — não conta contra a cota de solicitações.

Ferramentas de monitor

As seis ferramentas de leitura abaixo estão sempre disponíveis e expõem a API pública /v1/api/monitors para leitura de configuração e saída de monitores. create_monitor e update_monitor não estão sempre ativas — solicite-as explicitamente via ?tools=create_monitor,update_monitor ou o perfil monitoring, já que a maioria das sessões nunca as chama e o esquema compartilhado de monitores é grande.

Ferramenta	Descrição
`list_monitors`	Liste e filtre monitores por UUID, nome, status do ciclo de vida ou classificação EVENT, MENTIONS e TOPIC.
`get_monitor`	Recupere a configuração completa de um monitor, incluindo seu objetivo, consulta, esquema de saída, agendamento, lista de acompanhamento e pontos de contato.
`get_monitor_events`	Recupere eventos estruturados emitidos por monitores EVENT e MENTIONS com dados extraídos, entidades, resumos e artigos relacionados.
`get_monitor_newsletters`	Recupere resumos agendados legíveis por humanos gerados por monitores, normalmente para monitores TOPIC.
`get_monitor_summaries`	Recupere o histórico contínuo de resumos de monitores gerados por IA.
`set_monitor_status`	Ative, pause ou arquive um monitor. O arquivamento não pode ser revertido pela API pública.
`create_monitor` (opt-in)	Crie um monitor DRAFT ou ACTIVE com consulta tipada, esquema de saída, agendamento e configuração de entrega. O padrão é DRAFT.
`update_monitor` (opt-in)	Atualize parcialmente a configuração do monitor preservando campos omitidos.

Ferramentas de plataforma

Somente leitura por padrão; opte por participar via ?tools= (por nome ou pelo perfil platform).

Ferramenta	Descrição
`get_source_by_id`	Consulte uma fonte de notícias por ID exato ou domínio para obter detalhes completos (status de paywall, nomes alternativos, localização).
`get_top_topics`	Tópicos cuja cobertura está em alta em relação a um período de referência.
`get_story_stats`	Volume ou velocidade de publicação em nível de história (manchetes agrupadas) ao longo do tempo.
`watchlists`	Liste, obtenha por ID ou resolva por nome as listas de acompanhamento de pessoas e empresas da sua organização.
`source_groups`	Liste, obtenha por ID ou resolva por nome os pacotes personalizados de grupos de fontes da sua organização.
`contact_points`	Liste ou obtenha por UUID os canais de entrega de notificações de monitores da sua organização (e-mail/webhook).
`article_refresh`	Verifique o status de um trabalho de atualização de artigos em segundo plano ou visualize dados de atualização em cache para até 100 IDs de artigos — somente leitura, não é possível enviar novos trabalhos.
`create_watchlist` / `update_watchlist`	Crie ou atualize parcialmente uma lista de acompanhamento. Usado somente quando solicitado explicitamente.
`create_source_group` / `update_source_group`	Crie ou atualize parcialmente um grupo de fontes personalizado. Usado somente quando solicitado explicitamente.

Prompts de pesquisa

O servidor também registra seis prompts MCP reutilizáveis que codificam playbooks de encadeamento de ferramentas em várias etapas, para que um host que exiba prompts obtenha o encadeamento correto sem depender do modelo para reconstruí-lo: entity_deep_dive, narrative_trace, coverage_trend, journalist_beat_profile, competitive_landscape e spike_explainer.

Recursos de referência

Orientações detalhadas estão disponíveis sob demanda como recursos MCP, em vez de instruções sempre ativas: perigon://reference/fields (semântica dos campos de resposta), perigon://reference/chaining (playbooks de pesquisa entre endpoints), perigon://reference/entitlements (mapeamento de escopo para comportamento desta sessão) e perigon://reference/charts (regras de formatação de gráficos do Signal Insights).

Ferramentas do Signal Insights

Chaves de API com o escopo Signal Insights desbloqueiam um conjunto adicional de ferramentas para consultar, exportar e analisar seus dados de sinais de IA com um sandbox Python persistente.

Padrão de workspace

As ferramentas do Signal Insights usam um identificador de workspace explícito (conforme SEP-2567):

Chame create_insights_workspace uma vez no início de uma conversa.
Passe o ID do workspace retornado para cada chamada subsequente de ferramenta de análise.
Arquivos gravados em execute_code ou shell persistem entre chamadas dentro do mesmo workspace. Os dados exportados são acessíveis em /home/user/workspace/artifacts/ dentro do sandbox.
Se você retomar um chat após uma reinicialização, o UUID do workspace da conversa anterior ainda é válido — o kernel do sandbox será novo, mas seus artefatos S3 exportados são preservados.

Lista de ferramentas do Signal Insights

Ferramenta	Tipo	Descrição
`signal_insights_create_workspace`	Configuração	Crie um workspace para a conversa. Deve ser chamado primeiro para as ferramentas de sandbox.
`signal_insights_search_signals`	Leitura	Pesquise sinais por nome ou objetivo; filtro opcional `classificationTypes`.
`signal_insights_read_signal`	Leitura	Obtenha metadados do sinal (classificação, esquema ou contagens de boletins).
`signal_insights_list_newsletters`	Leitura	Liste boletins para um sinal TOPIC (título + trecho).
`signal_insights_read_newsletter`	Leitura	Busque o conteúdo completo do boletim como markdown.
`signal_insights_export_events`	Dados	Exporte eventos para S3 (somente EVENT/MENTIONS). Retorna uma prévia e o caminho do arquivo.
`signal_insights_execute_code`	Sandbox	Execute Python em um kernel IPython persistente. pandas, numpy, matplotlib e mais pré-instalados.
`signal_insights_preview_chart`	Sandbox	Renderize gráficos no visualizador interativo de gráficos.
`signal_insights_shell`	Sandbox	Execute comandos bash no sandbox.
`signal_insights_list_files`	Arquivos	Liste arquivos no workspace do sandbox.
`signal_insights_read_file`	Arquivos	Leia um arquivo do workspace.
`signal_insights_write_file`	Arquivos	Grave um arquivo no workspace.
`signal_insights_grep`	Arquivos	Pesquise o conteúdo de arquivos com um padrão regex.
`signal_insights_str_replace`	Arquivos	Encontre e substitua uma string em um arquivo.

Exemplo de configuração — somente Signal Insights

{
  "mcpServers": {
    "perigon": {
      "url": "https://mcp.perigon.io/v1/mcp?tools=signal_insights_create_workspace,signal_insights_search_signals,signal_insights_read_signal,signal_insights_list_newsletters,signal_insights_read_newsletter,signal_insights_export_events,signal_insights_execute_code,signal_insights_preview_chart,signal_insights_shell,signal_insights_list_files,signal_insights_read_file,signal_insights_write_file,signal_insights_grep,signal_insights_str_replace",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_PERIGON_API_KEY"
      }
    }
  }
}

Exemplo de configuração — Signal Insights combinado com ferramentas de notícias

{
  "mcpServers": {
    "perigon": {
      "url": "https://mcp.perigon.io/v1/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_PERIGON_API_KEY"
      }
    }
  }
}

Sem o filtro ?tools=, todas as ferramentas permitidas pelas permissões da sua chave de API ficam ativas.

Problemas / Contribuição

Problemas

Este servidor MCP ainda está em desenvolvimento enquanto determinamos quais casos de uso nossos usuários desejam resolver com este servidor. Mas se você tiver solicitações especiais ou recursos que gostaria de ver, não hesite em abrir uma issue no GitHub neste repositório. Aceitaremos qualquer feedback com prazer.

Contribuição

Esta ferramenta é intencionalmente de código aberto, então se você quiser ver algum recurso específico, abra uma issue ou um PR e alguém da Perigon fará a revisão.

Desenvolvimento local

Estamos usando bun para gerenciamento de pacotes.

Variáveis de ambiente

Adicione as seguintes variáveis de ambiente ao .dev.vars

Variável	Descrição
`ANTHROPIC_API_KEY`	Chave da API Anthropic (usada para o playground)
`PERIGON_API_KEY`	Chave da API Perigon (usada para o playground)
`POKEY_SIGNAL_INSIGHTS_BASE_URL`	URL interna do serviço Pokey para as ferramentas MCP do Signal Insights (ex.: `http://localhost:3001`). Necessária apenas ao usar as ferramentas do Signal Insights.

Se você deseja contribuir com o playground MCP (inspetor de ferramentas e chat), certifique-se de modificar o arquivo de hosts da sua rede (/etc/hosts no Mac) para incluir o seguinte

127.0.0.1 local-mcp.perigon.io

Isso permitirá que os cookies do perigon.io fiquem disponíveis para você durante o desenvolvimento local.

# install deps
bun i
# Runs the mcp server and the mcp playground
bun dev