Upriver

MCP da Upriver

Contexto em tempo real sobre criadores, públicos, marcas, tendências e patrocínios — para aplicações de IA.

Sobre a Upriver

A Upriver fornece uma API que transforma o que acontece online em contexto confiável e em tempo real para aplicações de IA. Ela entrega sinais baseados em evidências — cada um fundamentado em fontes reais — em:

• Creators — criadores e perfis relevantes
• Audiences — personas, interesses, idioma e humor
• Brands — marcas e como estão sendo discutidas
• Products — menções a produtos e casos de uso
• Trends — tópicos e formatos ganhando atenção
• Sponsorships — relacionamentos e posicionamentos entre marcas e criadores

Este repositório é a casa do servidor Model Context Protocol (MCP) da Upriver, que leva esse contexto a qualquer assistente ou agente de IA compatível com MCP.

Conectar

É um servidor remoto e hospedado — nada para instalar ou executar. O login via OAuth funciona em todos os clientes. O cabeçalho X-API-Key é compatível com Claude Code, Cursor, VS Code, Cline, Windsurf, Codex CLI, Goose e Zed — mas não com as UIs de conector do Claude ou do ChatGPT, que aceitam apenas OAuth.

Claude Code (CLI)

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

Para usar uma chave de API em vez de OAuth, passe-a como cabeçalho:

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

Cursor

Adicione a ~/.cursor/mcp.json (global) ou .cursor/mcp.json (por projeto) e conecte-a em Settings → Tools & Integrations para entrar:

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

Para autenticação por chave de API, adicione "headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" }.

VS Code (GitHub Copilot)

O VS Code usa um formato diferente — servers de nível superior e um "type": "http" obrigatório. Adicione a .vscode/mcp.json (ou execute MCP: Add Server):

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

Para autenticação por chave de API, adicione "headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" }.

Claude Desktop e claude.ai

No Claude, vá em Customize → Connectors → "+" → Add custom connector, dê o nome Upriver, cole https://mcp.upriver.ai/mcp e clique em Connect para entrar. (O conector do Claude aceita apenas OAuth — não há campo para chave de API, e não adicione uma entrada url bruta em claude_desktop_config.json; o aplicativo desktop a rejeita.)

Cline

Use a aba Remote Servers (Transport: Streamable HTTP) ou edite cline_mcp_settings.json — o campo type é obrigatório, caso contrário o Cline volta para o SSE legado e falha:

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

Windsurf

Edite ~/.codeium/windsurf/mcp_config.json — o campo do Windsurf é serverUrl:

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

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

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

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

Qualquer outro cliente MCP

A maioria dos clientes usa o formato do Cursor acima (mcpServers + url, headers opcional). Para agentes que leem manifestos de instalação, consulte llms-install.md.

IDEs JetBrains: o MCP funciona, mas a IDE atualmente descarta cabeçalhos de solicitação personalizados e ainda não oferece suporte a OAuth para servidores remotos, portanto a autenticação X-API-Key da Upriver ainda não consegue se conectar lá — vamos listá-la assim que a JetBrains lançar a correção.

Ferramentas disponíveis hoje

O servidor MCP atualmente expõe os breakout topics da Upriver — assuntos emergentes ganhando tração online em tecnologia, esportes e política, cada um retornado com citações de fontes fundamentadas, para que o modelo raciocine com base em evidências reais em vez de suposições.

Ambas as ferramentas são somente leitura. Cada uma retorna até limit tópicos (padrão 10, máximo 25), e cada tópico traz até 5 citações de fontes, além de um sinalizador has_more quando houver mais tópicos além da página.

breakout_search_topics

Pesquise tópicos em destaque por palavra-chave.

breakout_list_topics

Navegue pelos tópicos em destaque ganhando tração agora.

Cada tópico inclui seu nome, vertical, status do ciclo de vida, um sinal de momentum e suas principais citações (título, URL, categoria da fonte e horário de publicação).

Mais por vir

Os breakout topics são a primeira fatia da API da Upriver a chegar como ferramentas MCP. A API completa — Creators, Audiences, Brands, Products, Trends e Sponsorships — está documentada em docs.upriver.ai, e estamos lançando esses endpoints como ferramentas MCP. Fique de olho neste repositório para novas ferramentas conforme forem lançadas.

Acesso

O acesso ao MCP da Upriver é provisionado por conta. Solicite acesso em dashboard.upriver.ai ou envie um e-mail para support@upriver.ai. Depois que sua conta for ativada, o mesmo login da Upriver (ou chave de API) funciona em todos os clientes MCP.

Links

• Docs — https://docs.upriver.ai
• Dashboard — https://dashboard.upriver.ai
• Site — https://upriver.ai

Licença

O conteúdo deste repositório — documentação de conexão e metadados de listagem — é lançado sob a Licença MIT.

O serviço MCP hospedado da Upriver e a API da Upriver são operados pela Potato Laboratories, Inc., que opera como Upriver, e são regidos pelos Termos de Serviço da Upriver. A Licença MIT cobre este repositório apenas — não o serviço, nem os dados que ele retorna. "Upriver" e o logotipo da Upriver são marcas registradas da Potato Laboratories, Inc. e não são cobertos pela Licença MIT.