newsmcp

Notícias mundiais em tempo real para agentes de IA — eventos agrupados de centenas de fontes, classificados por 12 tópicos e mais de 30 regiões, ranqueados por importância. Gratuito, sem chave de API.

GitHub

Experimente este MCPPatrocinado

Documentação

NewsMCP — Notícias mundiais para agentes de IA

newsmcp.io • integrações • API REST

Eventos de notícias em tempo real, agrupados por IA a partir de centenas de fontes, classificados por tópico e geografia, ranqueados por importância.

Grátis. Sem chave de API. Um comando para instalar.

Cobertura

12 tópicos — politics economy technology science health environment sports culture crime military education society

30 regiões — 6 continentes e 24 países. Filtre por europe, asia, united-states, germany, japan, ukraine, e mais.

Centenas de fontes — Artigos agrupados em eventos em tempo real, ranqueados por contagem de fontes e pontuação de impacto.

Integrações

Plataforma	Pacote	Instalação
Claude Desktop	`@newsmcp/server`	Config MCP
Plugin Claude Code	`newsmcp`	`/plugin install`
Claude Code MCP	`@newsmcp/server`	`claude mcp add`
Cursor	`@newsmcp/server`	Config MCP
Windsurf	`@newsmcp/server`	Config MCP
OpenAI Codex	`@newsmcp/server`	`codex mcp add`
Gemini CLI	`@newsmcp/server`	`settings.json`
OpenCode	`@newsmcp/server`	`opencode mcp add`
Smithery	`@newsmcp/server`	`npx @smithery/cli`
Plugin OpenClaw	`@newsmcp/openclaw`	`openclaw plugins install`
Habilidade OpenClaw	`newsmcp-skill`	`clawhub install`
API REST	—	`curl https://newsmcp.io/v1/news/`

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

Plugin Claude Code

/plugin marketplace add pranciskus/newsmcp
/plugin install newsmcp

Claude Code MCP

claude mcp add newsmcp -- npx -y @newsmcp/server

Cursor

Adicione ao .cursor/mcp.json:

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

Windsurf

Adicione à configuração MCP:

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

OpenAI Codex

codex mcp add newsmcp -- npx -y @newsmcp/server

Ou adicione ao ~/.codex/config.toml:

[mcp_servers.newsmcp]
command = "npx"
args = ["-y", "@newsmcp/server"]

Gemini CLI

Adicione ao ~/.gemini/settings.json (ou ao .gemini/settings.json local do projeto):

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

OpenCode

opencode mcp add

Ou adicione ao ~/.config/opencode/opencode.json (ou ao .opencode/opencode.json local do projeto):

{
  "mcp": {
    "newsmcp": {
      "type": "local",
      "enabled": true,
      "command": ["npx", "-y", "@newsmcp/server"]
    }
  }
}

Smithery

npx -y @smithery/cli install @newsmcp/server --client claude

Plugin OpenClaw

openclaw plugins install @newsmcp/openclaw

Nenhuma configuração necessária — funciona imediatamente. Veja @newsmcp/openclaw para opções.

Habilidade OpenClaw

clawhub install newsmcp-skill

Alternativa leve — um único SKILL.md que ensina o agente a chamar a API REST via curl. Sem dependências. Veja newsmcp-skill no ClawHub.

Ferramentas MCP

Quatro ferramentas. Essa é a interface.

`get_news`

Principais eventos acontecendo agora. Filtre por tópico, região, janela de tempo.

Parâmetro	Tipo	Padrão	Descrição
`topics`	string	—	Slugs de tópicos separados por vírgula: `politics,technology`
`geo`	string	—	Slugs de regiões separados por vírgula: `europe,lithuania`
`hours`	number	24	Janela de tempo em horas (1–168)
`page`	number	1	Número da página
`per_page`	number	20	Resultados por página (máx. 50)
`order_by`	string	`-sources_count`	Campo de ordenação (veja abaixo)

Opções de ordenação: -sources_count, -impact_score, -last_seen_at, -entries_count (prefixo - para decrescente)

`get_news_detail`

Detalhes completos de um único evento — todos os artigos de origem, contexto gerado por IA, análise de impacto, tags de entidades.

Parâmetro	Tipo	Descrição
`event_id`	string	UUID do evento dos resultados de `get_news`

`get_topics`

Lista todas as categorias de tópicos disponíveis para filtragem. Sem parâmetros.

crime culture economy education environment health military politics science society sports technology

`get_regions`

Lista todas as regiões geográficas — 6 continentes e 24 países — disponíveis para filtragem. Sem parâmetros.

Como os agentes usam

Prompt	O que acontece
"O que está acontecendo no mundo?"	`get_news` com padrões — top 20 eventos por cobertura de fontes
"Alguma notícia de tecnologia da Europa hoje?"	`get_news` com `topics=technology`, `geo=europe`, `hours=24`
"Conte-me mais sobre esse terremoto"	`get_news_detail` com o UUID do evento
"Por quais tópicos posso filtrar?"	`get_topics` — retorna a lista completa
"Mostre-me notícias da Ásia esta semana"	`get_news` com `geo=asia`, `hours=168`

API REST

Não precisa de MCP? Acesse os endpoints diretamente. Mesmos dados, mesmos filtros.

URL base: https://newsmcp.io/v1

Método	Endpoint	Descrição
`GET`	`/news/`	Lista eventos de notícias com filtragem opcional
`GET`	`/news/{id}/`	Evento único com lista completa de artigos
`GET`	`/news/topics/`	Todas as categorias de tópicos
`GET`	`/news/regions/`	Todas as regiões geográficas

Parâmetros de consulta

Todos os parâmetros são opcionais. Combine livremente.

# Latest events
curl -s https://newsmcp.io/v1/news/ | jq

# Filter by topic
curl -s "https://newsmcp.io/v1/news/?topics=technology" | jq

# Filter by region
curl -s "https://newsmcp.io/v1/news/?geo=europe" | jq

# Last 12 hours, sorted by impact
curl -s "https://newsmcp.io/v1/news/?hours=12&order_by=-impact_score" | jq

# Combine everything
curl -s "https://newsmcp.io/v1/news/?topics=politics&geo=united+states&hours=48&per_page=5" | jq

Formato de resposta

{
  "events": [
    {
      "id": "cc3428ab-2ada-41bb-86ab-833fd39ffd8d",
      "summary": "Event description with AI-generated context...",
      "topics": ["technology", "politics"],
      "geo": ["united states"],
      "entries_count": 86,
      "sources_count": 45,
      "first_seen_at": "2026-02-15T04:06:41.728Z",
      "last_seen_at": "2026-03-03T05:00:30Z",
      "impact_score": 8,
      "entries": [
        {
          "title": "Article headline",
          "url": "https://source.com/article",
          "domain": "source.com",
          "published_at": "2026-03-03T05:00:30Z"
        }
      ]
    }
  ],
  "total": 142,
  "page": 1,
  "per_page": 20
}

Como funciona

Coleta — Centenas de fontes de notícias são rastreadas continuamente
Agrupamento — Artigos sobre o mesmo evento são agrupados usando embeddings vetoriais
Classificação — Cada evento é marcado com tópicos e entidades geográficas
Ranqueamento — Eventos são pontuados por contagem de fontes, impacto e atualidade
Entrega — JSON limpo via API REST e servidor MCP

Eventos são atualizados em tempo real conforme novos artigos aparecem. A IA de agrupamento mescla coberturas duplicadas automaticamente.

Configuração

Aponte para um backend de API diferente:

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"],
      "env": {
        "NEWS_API_BASE_URL": "https://your-api.example.com/v1"
      }
    }
  }
}

Lançamentos (GitHub Actions + OIDC)

A publicação é orientada por tags via .github/workflows/release.yml:

Gatilho: push da tag v*.*.*
Publica @newsmcp/server e @newsmcp/openclaw no npm via Trusted Publishing (OIDC)
Publica metadados MCP com mcp-publisher login github-oidc
Cria um release no GitHub com notas geradas

Configuração única

Configurações do pacote npm: Para @newsmcp/server e @newsmcp/openclaw, adicione um Trusted Publisher apontando para:
- Proprietário: pranciskus
- Repositório: newsmcp
- Arquivo de workflow: .github/workflows/release.yml
- Ambiente: deixe vazio (a menos que você use um intencionalmente)
Registro MCP: Garanta que o repositório/pacote esteja autorizado para publicação OIDC do GitHub no Registro MCP.

Fluxo de lançamento

Atualize as versões em:
- packages/mcp-server/package.json
- packages/openclaw-plugin/package.json
- packages/mcp-server/server.json
- package-lock.json
Faça commit e push para main
Crie e envie a tag:

git tag -a vX.Y.Z -m "vX.Y.Z"
git push origin vX.Y.Z

O workflow faz a publicação e o release no GitHub automaticamente.

Estrutura do repositório

newsmcp/
├── .github/workflows/       # CI/CD workflows (release automation)
├── .claude-plugin/          # Marketplace manifest
├── packages/
│   ├── mcp-server/          # @newsmcp/server — MCP server (npm)
│   ├── claude-code-plugin/  # newsmcp — Claude Code plugin
│   ├── openclaw-plugin/     # @newsmcp/openclaw — OpenClaw plugin (npm)
│   └── skill/               # newsmcp-skill — OpenClaw skill (ClawHub)
├── publish.sh                # Build, test, publish workflow
├── README.md
└── LICENSE

Licença

MIT