Base2026 Public MCP

MCP gratuito y de solo lectura para investigación de SEO y marketing con atribución de fuentes, basado en un corpus curado de videos de expertos.

Documentación

MCP para agentes de IA

Conecta un agente a seis herramientas Base2026 acotadas y de solo lectura a través de MCP HTTP remoto estándar.

Base2026 expone un pequeño servidor MCP público para agentes de IA que necesitan evidencia de video de formato corto atribuible. Es gratuito, sin clave y de solo lectura. El servidor envuelve las mismas tablas públicas de búsqueda y proyección D1 que el sitio web; no abre el pipeline privado de ingesta o revisión.

Endpoint y transporte

  • Endpoint MCP: POST https://base2026.dev/api/mcp
  • Guía humana: https://base2026.dev/mcp
  • Transporte: HTTP Streamable sin estado con respuestas JSON.
  • Negociación de protocolo actual: 2026-07-28 hasta server/discover.
  • Compatibilidad: se aceptan solicitudes heredadas initialize para versiones de protocolo 2025 compatibles.
  • Sesiones: ninguna. Eventos enviados por el servidor: ninguno. DELETE: no compatible.
  • Autenticación: ninguna; los datos son intencionalmente públicos.
  • Protección contra abuso: el Worker utiliza el binding MCP_RATE_LIMIT configurado a 60 solicitudes por minuto por identidad de borde; si el binding no está disponible, la ruta falla de forma cerrada con 503 en lugar de servir un endpoint sin protección.

Los clientes modernos deben enviar Content-Type: application/json, MCP-Protocol-Version, Mcp-Method y los metadatos de protocolo correspondientes en params._meta. Una solicitud tools/call también envía Mcp-Name que coincide con params.name. El endpoint valida estos encabezados y rechaza discrepancias.

Descubre el servidor

curl -sS https://base2026.dev/api/mcp \
  -H 'content-type: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: server/discover' \
  --data '{"jsonrpc":"2.0","id":"discover","method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}'

La respuesta anuncia una capacidad de herramientas, versiones de protocolo, versión del servidor, guía de caché e instrucciones de solo público. tools/list devuelve los esquemas de herramientas deterministas y las anotaciones de solo lectura.

Conjunto de herramientas

HerramientaArgumentosDevuelve
search_sourcesquery, opcional creator_handle, topic_id, platform, limit, offsetResúmenes de fuentes públicas distintivas, extractos acotados y atribución
get_sourcesource_id (también acepta un alias de elemento, video o publicación)Hasta ocho pasajes públicos y hasta tres tarjetas de evidencia aplicadas
get_creatorhandle con o sin @Metadatos públicos del creador, conteos de temas y muestras de fuentes acotadas
get_topictopic_id exactoConteos públicos de fuentes/creadores/insights y muestras acotadas
get_topic_signaltopic_id exactoPuerta de evidencia determinista, no una clasificación de tendencias
get_public_manifestSin argumentosDimensiones públicas actuales de D1, enlaces de endpoint y banderas de política

Llamar a una herramienta

curl -sS https://base2026.dev/api/mcp \
  -H 'content-type: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' \
  -H 'Mcp-Name: search_sources' \
  --data '{"jsonrpc":"2.0","id":"search-1","method":"tools/call","params":{"name":"search_sources","arguments":{"query":"AI search","limit":5},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}'

Los resultados de las herramientas contienen tanto una representación de texto como structuredContent. Cada resultado lleva un objeto public_boundary. Cuando una página de origen está disponible, el resultado conserva tanto la URL de origen original como la URL de página canónica de Base2026.

Límites y errores

  • Los cuerpos de solicitud MCP están limitados a 64 KiB.
  • El límite de tasa configurado de Cloudflare devuelve 429 con Retry-After: 60 después de que se agote el presupuesto por minuto por identidad.
  • search_sources está limitado a 20 resultados y desplazamiento 1,000.
  • La búsqueda de fuentes devuelve como máximo ocho pasajes y tres tarjetas públicas aplicadas.
  • Las muestras de creadores y temas están acotadas; los conteos son lecturas D1 actuales al momento de la llamada, no una afirmación de completitud sobre TikTok o la web.
  • get_topic_signal informa strong solo cuando el conteo de fuentes es al menos 5, el conteo de creadores al menos 2 y el conteo de insights públicos aplicados al menos 3.
  • JSON inválido, versiones no compatibles, discrepancias de encabezados, métodos desconocidos y herramientas no compatibles devuelven errores JSON-RPC estructurados.

Los agentes deben citar la URL de origen original y cualquier página de origen de Base2026 devuelta. No presentes un resultado acotado como una clasificación en tiempo real, corpus completo, transcripción completa o confirmación independiente de la afirmación del creador. Cada versión de producción verifica el binding del límite de tasa mediante la lectura de la versión de Cloudflare y luego ejercita el descubrimiento y una llamada de herramienta acotada contra el endpoint en vivo.

Frontera de privacidad

El manejador lee solo el binding público DB y nunca consulta los bindings privados separados del Worker. No tiene herramientas de escritura, sin subtítulos crudos ni ASR, sin acceso a medios, sin credenciales, sin acceso a bandeja de entrada y sin actuador de publicación. Consulta la política de fuente y contenido para los límites de corrección y eliminación.

Para comandos exactos de Codex y Claude Code, consulta plugins e integraciones.