Upriver

Sepa qué está ganando tracción en línea: temas emergentes en tecnología, deportes y política, con citas.

Documentación

Upriver MCP

Contexto en tiempo real sobre creadores, audiencias, marcas, tendencias y patrocinios — para aplicaciones de IA.

Acerca de Upriver

Upriver proporciona una API que convierte lo que sucede en línea en contexto confiable y en tiempo real para aplicaciones de IA. Ofrece señales respaldadas por evidencia — cada una fundamentada en fuentes reales — en:

Creadores — creadores y perfiles relevantes
Audiencias — personas, intereses, lenguaje y humor
Marcas — marcas y cómo se discuten
Productos — menciones de productos y casos de uso
Tendencias — temas y formatos que ganan atención
Patrocinios — relaciones y colocaciones entre marcas y creadores

Este repositorio es el hogar del servidor del Protocolo de Contexto de Modelo (MCP) de Upriver, que lleva ese contexto a cualquier asistente o agente de IA compatible con MCP.

Conexión


Endpoint	`https://mcp.upriver.ai/mcp`
Transporte	HTTP transmisible
Autenticación	Inicia sesión con Upriver (OAuth), o envía tu clave API de Upriver en el encabezado `X-API-Key`

Es un servidor remoto y alojado — no hay nada que instalar o ejecutar. El inicio de sesión con OAuth funciona en todos los clientes. El encabezado X-API-Key es compatible con Claude Code, Cursor, VS Code, Cline, Windsurf, Codex CLI, Goose y Zed — pero no con las interfaces de conectores de Claude o ChatGPT, que son solo OAuth.

Claude Code (CLI)

claude mcp add --transport http upriver https://mcp.upriver.ai/mcp

Para usar una clave API en lugar de OAuth, pásala como encabezado:

claude mcp add --transport http upriver https://mcp.upriver.ai/mcp \
  --header "X-API-Key: YOUR_UPRIVER_API_KEY"

Cursor

Agrégalo a ~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto), luego conéctalo en Configuración → Herramientas e integraciones para iniciar sesión:

{ "mcpServers": { "upriver": { "url": "https://mcp.upriver.ai/mcp" } } }

Para autenticación con clave API, agrega "headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" }.

VS Code (GitHub Copilot)

VS Code usa una forma diferente — servers de nivel superior y un "type": "http" obligatorio. Agrégalo a .vscode/mcp.json (o ejecuta MCP: Agregar servidor):

{ "servers": { "upriver": { "type": "http", "url": "https://mcp.upriver.ai/mcp" } } }

Para autenticación con clave API, agrega "headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" }.

Claude Desktop y claude.ai

En Claude, ve a Personalizar → Conectores → "+" → Agregar conector personalizado, nómbralo Upriver, pega https://mcp.upriver.ai/mcp, luego Conectar e inicia sesión. (El conector de Claude es solo OAuth — no hay campo para una clave API, y no agregues una entrada url sin procesar a claude_desktop_config.json; la aplicación de escritorio la rechaza).

Cline

Usa la pestaña Servidores remotos (Transporte: HTTP transmisible), o edita cline_mcp_settings.json — el campo type es obligatorio, o Cline vuelve al SSE heredado y falla:

{ "mcpServers": { "upriver": { "type": "streamableHttp", "url": "https://mcp.upriver.ai/mcp" } } }

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json — el campo de Windsurf es serverUrl:

{ "mcpServers": { "upriver": { "serverUrl": "https://mcp.upriver.ai/mcp" } } }

Más clientes — Codex CLI, ChatGPT, Goose, Zed

Codex CLI (OpenAI)

codex mcp add upriver --url https://mcp.upriver.ai/mcp --header X-API-Key=YOUR_UPRIVER_API_KEY

ChatGPT — Habilita el Modo desarrollador (Configuración → Aplicaciones y conectores → Avanzado), luego Configuración → Conectores → Crear, nómbralo Upriver, pega https://mcp.upriver.ai/mcp, elige OAuth e inicia sesión. (Sin campo de encabezado personalizado — solo OAuth en la interfaz).

Goose — agrégalo a ~/.config/goose/config.yaml:

extensions:
  upriver:
    type: streamable_http
    uri: https://mcp.upriver.ai/mcp
    enabled: true
    headers:
      X-API-Key: "${UPRIVER_API_KEY}"

Zed — agrégalo a settings.json bajo context_servers:

{ "context_servers": { "upriver": { "url": "https://mcp.upriver.ai/mcp", "headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" } } } }

Cualquier otro cliente MCP

La mayoría de los clientes usan la forma de Cursor anterior (mcpServers + url, headers opcional). Para agentes que leen manifiestos de instalación, consulta llms-install.md.

IDE de JetBrains: MCP funciona, pero el IDE actualmente elimina los encabezados de solicitud personalizados y aún no admite OAuth para servidores remotos, por lo que la autenticación X-API-Key de Upriver no puede conectarse allí todavía — lo listaremos una vez que JetBrains publique la corrección.

Herramientas disponibles hoy

El servidor MCP actualmente expone los temas emergentes de Upriver — temas emergentes que ganan tracción en línea en tecnología, deportes y política, cada uno devuelto con citas de fuentes fundamentadas para que el modelo razone a partir de evidencia real en lugar de adivinar.

Ambas herramientas son de solo lectura. Cada una devuelve hasta limit temas (predeterminado 10, máximo 25), cada tema con hasta 5 citas de fuentes, más un indicador has_more cuando hay más temas más allá de la página.

`breakout_search_topics`

Busca temas emergentes por palabra clave.

Parámetro	Tipo	Descripción
`query`	cadena · obligatorio	Búsqueda en lenguaje natural, p. ej. `"AI video effects"`.
`vertical`	enumeración	Restringe a `tech`, `sports` o `politics`.
`limit`	entero	1–25 (predeterminado 10).
`citation_sources`	matriz	Restringe citas a cualquiera de `news`, `reddit`, `twitter`.

`breakout_list_topics`

Explora temas emergentes que ganan tracción en este momento.

Parámetro	Tipo	Descripción
`vertical`	enumeración	Restringe a `tech`, `sports` o `politics`.
`status`	enumeración	Filtro de ciclo de vida: `active` (predeterminado), `emerging`, `trending`, `declining`, `detected` o `all`.
`limit`	entero	1–25 (predeterminado 10).
`citation_sources`	matriz	Restringe citas a cualquiera de `news`, `reddit`, `twitter`.

Cada tema incluye su nombre, vertical, estado del ciclo de vida, una señal de impulso y sus citas principales (título, URL, categoría de fuente y hora de publicación).

Más en camino

Los temas emergentes son la primera parte de la API de Upriver que llega como herramientas MCP. La API completa — Creadores, Audiencias, Marcas, Productos, Tendencias y Patrocinios — está documentada en docs.upriver.ai, y estamos implementando esos endpoints como herramientas MCP. Observa este repositorio para nuevas herramientas a medida que se publiquen.

Acceso

El acceso a Upriver MCP se aprovisiona por cuenta. Solicita acceso en dashboard.upriver.ai o envía un correo a support@upriver.ai. Una vez que tu cuenta esté habilitada, el mismo inicio de sesión de Upriver (o clave API) funciona en todos los clientes MCP.

Enlaces

Documentación — https://docs.upriver.ai
Panel — https://dashboard.upriver.ai
Sitio web — https://upriver.ai

Licencia

El contenido de este repositorio — documentación de conexión y metadatos de listado — se publica bajo la Licencia MIT.

El servicio MCP alojado de Upriver y la API de Upriver son operados por Potato Laboratories, Inc. d/b/a Upriver y se rigen por los Términos de servicio de Upriver. La Licencia MIT cubre solo este repositorio — no el servicio, ni los datos que devuelve. "Upriver" y el logotipo de Upriver son marcas comerciales de Potato Laboratories, Inc. y no están cubiertos por la Licencia MIT.