newsmcp

Noticias mundiales en tiempo real para agentes de IA: eventos agrupados de cientos de fuentes, clasificados por 12 temas y más de 30 regiones, ordenados por importancia. Gratuito, sin clave API.

Documentación

NewsMCP — Noticias mundiales para agentes de IA

newsmcp.io  •  integraciones  •  API REST

npm @newsmcp/server npm @newsmcp/openclaw MIT


Eventos de noticias en tiempo real, agrupados por IA desde cientos de fuentes, clasificados por tema y geografía, ordenados por importancia.

Gratis. Sin clave de API. Un comando para instalar.

Cobertura

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

30 regiones — 6 continentes y 24 países. Filtra por europe, asia, united-states, germany, japan, ukraine, y más.

Cientos de fuentes — Artículos agrupados en eventos en tiempo real, ordenados por número de fuentes y puntuación de impacto.

Integraciones

PlataformaPaqueteInstalación
Claude Desktop@newsmcp/serverConfiguración MCP
Plugin de Claude Codenewsmcp/plugin install
Claude Code MCP@newsmcp/serverclaude mcp add
Cursor@newsmcp/serverConfiguración MCP
Windsurf@newsmcp/serverConfiguración MCP
OpenAI Codex@newsmcp/servercodex mcp add
Gemini CLI@newsmcp/serversettings.json
OpenCode@newsmcp/serveropencode mcp add
Smithery@newsmcp/servernpx @smithery/cli
Plugin de OpenClaw@newsmcp/openclawopenclaw plugins install
Habilidad de OpenClawnewsmcp-skillclawhub install
API REST—curl https://newsmcp.io/v1/news/

Claude Desktop

Añade a claude_desktop_config.json:

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

Plugin de Claude Code

/plugin marketplace add pranciskus/newsmcp
/plugin install newsmcp

Claude Code MCP

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

Cursor

Añade a .cursor/mcp.json:

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

Windsurf

Añade a la configuración MCP:

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

OpenAI Codex

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

O añade a ~/.codex/config.toml:

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

Gemini CLI

Añade a ~/.gemini/settings.json (o .gemini/settings.json local del proyecto):

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

OpenCode

opencode mcp add

O añade a ~/.config/opencode/opencode.json (o .opencode/opencode.json local del proyecto):

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

Smithery

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

Plugin de OpenClaw

openclaw plugins install @newsmcp/openclaw

No se necesita configuración: funciona directamente. Consulta @newsmcp/openclaw para ver las opciones.

Habilidad de OpenClaw

clawhub install newsmcp-skill

Alternativa ligera: un único SKILL.md que enseña al agente a llamar a la API REST mediante curl. Sin dependencias. Consulta newsmcp-skill en ClawHub.

Herramientas MCP

Cuatro herramientas. Esa es la interfaz.

get_news

Principales eventos que ocurren ahora mismo. Filtra por tema, región y ventana de tiempo.

ParámetroTipoPredeterminadoDescripción
topicsstring—Slugs de temas separados por comas: politics,technology
geostring—Slugs de regiones separados por comas: europe,lithuania
hoursnumber24Ventana de tiempo en horas (1–168)
pagenumber1Número de página
per_pagenumber20Resultados por página (máx. 50)
order_bystring-sources_countCampo de ordenación (ver más abajo)

Opciones de ordenación: -sources_count, -impact_score, -last_seen_at, -entries_count (prefijo - para descendente)

get_news_detail

Detalles completos de un único evento: todos los artículos fuente, contexto generado por IA, análisis de impacto, etiquetas de entidades.

ParámetroTipoDescripción
event_idstringUUID del evento de los resultados de get_news

get_topics

Enumera todas las categorías de temas disponibles para filtrar. Sin parámetros.

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

get_regions

Enumera todas las regiones geográficas (6 continentes y 24 países) disponibles para filtrar. Sin parámetros.

Cómo lo usan los agentes

PromptQué ocurre
"¿Qué está pasando en el mundo?"get_news con valores predeterminados: los 20 principales eventos por cobertura de fuentes
"¿Hay noticias de tecnología de Europa hoy?"get_news con topics=technology, geo=europe, hours=24
"Cuéntame más sobre ese terremoto"get_news_detail con el UUID del evento
"¿Por qué temas puedo filtrar?"get_topics: devuelve la lista completa
"Muéstrame noticias de Asia esta semana"get_news con geo=asia, hours=168

API REST

¿No necesitas MCP? Accede directamente a los endpoints. Los mismos datos, los mismos filtros.

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

MétodoEndpointDescripción
GET/news/Lista eventos de noticias con filtrado opcional
GET/news/{id}/Evento único con lista completa de artículos
GET/news/topics/Todas las categorías de temas
GET/news/regions/Todas las regiones geográficas

Parámetros de consulta

Todos los parámetros son opcionales. Combínalos libremente.

# 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 respuesta

{
  "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
}

Cómo funciona

  1. Recopilar — Se extraen continuamente cientos de fuentes de noticias
  2. Agrupar — Los artículos sobre el mismo evento se agrupan mediante incrustaciones vectoriales
  3. Clasificar — Cada evento se etiqueta con temas y entidades geográficas
  4. Ordenar — Los eventos se puntúan por número de fuentes, impacto y actualidad
  5. Servir — JSON limpio mediante API REST y servidor MCP

Los eventos se actualizan en tiempo real a medida que aparecen nuevos artículos. La IA de agrupación fusiona automáticamente la cobertura duplicada.

Configuración

Apunta a un backend de API diferente:

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

Lanzamientos (GitHub Actions + OIDC)

La publicación se controla mediante etiquetas a través de .github/workflows/release.yml:

  • Disparador: etiqueta de push v*.*.*
  • Publica @newsmcp/server y @newsmcp/openclaw en npm mediante Trusted Publishing (OIDC)
  • Publica metadatos MCP con mcp-publisher login github-oidc
  • Crea un lanzamiento de GitHub con notas generadas

Configuración inicial

  1. Ajustes del paquete npm: Para @newsmcp/server y @newsmcp/openclaw, añade un Trusted Publisher que apunte a:
    • Propietario: pranciskus
    • Repositorio: newsmcp
    • Archivo de workflow: .github/workflows/release.yml
    • Entorno: déjalo vacío (a menos que uses uno intencionadamente)
  2. Registro MCP: Asegúrate de que el repositorio/paquete esté autorizado para la publicación OIDC de GitHub en el Registro MCP.

Flujo de lanzamiento

  1. Actualiza las versiones en:
    • packages/mcp-server/package.json
    • packages/openclaw-plugin/package.json
    • packages/mcp-server/server.json
    • package-lock.json
  2. Haz commit y push a main
  3. Crea y haz push de la etiqueta:
git tag -a vX.Y.Z -m "vX.Y.Z"
git push origin vX.Y.Z

El workflow realiza la publicación y el lanzamiento de GitHub automáticamente.

Estructura del repositorio

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

Licencia

MIT