SpecStream

Dale a tu agente listas terminadas desde la web en vivo: cada fila con su fuente, con precio por coincidencia. Pide en inglés sencillo por empresas, negocios locales, licitaciones, subvenciones, empleos o artículos de investigación y obtén solo las filas que encajan.

GitHub

Servidor MCP alojado

npx add-mcp 'https://api.specstream.ai/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

El motor de datos web en vivo para equipos y agentes.

Sitio web · Documentación · Precios · Registro MCP

Listas terminadas desde la web en vivo para tu agente, cada fila con su fuente, con precio antes de que se ejecute cualquier cosa. Pide la lista que necesites en palabras simples y obtén todo: solo las coincidencias, cada una con la página de la que proviene, mantenidas actualizadas y enviadas a donde trabajas. Pagas solo por las coincidencias.

Tu agente pide "bancos de alimentos en Texas, con sus ingresos anuales" y obtiene filas que puede citar, cada una con la página detrás. Ve el precio primero, y una búsqueda que no encuentra nada no cuesta nada.

A request, its price, and a list ready to use

Este repositorio contiene lo que instalas alrededor de SpecStream: configuración del cliente MCP, complementos y habilidades de agentes, SDK, el nodo de n8n, una Acción de GitHub y ejemplos. El producto en sí se ejecuta en specstream.ai. Licencia MIT.

Ruta	Qué es
`server.json`	Entrada para el Registro MCP oficial, `ai.specstream/specstream`
`skills/`	Habilidades de agente: `compile`, `review-work`, `approve-work`, `continue-work`
`plugins/claude-code/`	Complemento de Claude Code (servidor MCP y las cuatro habilidades)
`plugins/github-agent/`	Complemento para agentes que leen el formato de complementos de agentes
`.cursor-plugin/`	Complemento de Cursor
`packages/sdk-py/`	`specstream-client`: cliente de Python y el comando `specstream`
`packages/sdk-ts/`	`@specstream/sdk`: cliente de TypeScript
`packages/mcp-stdio/`	`specstream-mcp-stdio`: proxy stdio para clientes que solo inician servidores locales
`integrations/n8n/`	`n8n-nodes-specstream`: nodo comunitario de n8n
`integrations/vscode/`	Extensión de VS Code: inicio de sesión MCP y chat `@specstream`
`actions/find-action/`	Acción de GitHub que ejecuta una solicitud y sube un CSV
`Formula/`	Fórmula de Homebrew para la línea de comandos
`examples/`	SDK de Python, SDK de TypeScript, SDK de OpenAI Agents y LangChain

Conecta un agente

El servidor MCP es https://api.specstream.ai/mcp (HTTP Streamable, 97 herramientas). Tu agente trabaja en tu cuenta: el mismo saldo, permisos y límites de gasto que tienes.

Abre Agentes y API en el espacio de trabajo y crea una clave de API. Dale solo lo que la tarea necesita: lectura, preparación o ejecución, los proyectos que puede usar, una fecha de vencimiento y un límite de gasto.
Colócala en una variable de entorno, para que ningún archivo la contenga:
```
export SPECSTREAM_API_KEY="ss_live_..."
```
Agrega el servidor a tu cliente, a continuación.

Los clientes que admiten inicio de sesión MCP pueden conectarse sin una clave. Cada guía en specstream.ai/docs/mcp muestra los pasos actuales.

Las cuentas nuevas comienzan con $10 de trabajo gratis durante 30 días, sin tarjeta.

Claude

En Claude, ve a Personalizar > Conectores, elige Agregar conector personalizado, nómbralo SpecStream y pega https://api.specstream.ai/mcp. Pasos tanto para inicio de sesión como para clave: docs/mcp/claude.

Claude Code

claude mcp add --transport http specstream https://api.specstream.ai/mcp \
  --header "Authorization: Bearer $SPECSTREAM_API_KEY"

O instala el complemento, que agrega el servidor y las cuatro habilidades:

/plugin marketplace add Specstreamai/specstream-tools
/plugin install specstream@specstream

ChatGPT

Ve a Complementos de ChatGPT, elige el botón de más y luego Agregar servidor MCP personalizado. Pega https://api.specstream.ai/mcp en Conexión y establece Autenticación en OAuth. Pasos: docs/mcp/chatgpt.

Codex

Agrega a ~/.codex/config.toml:

[mcp_servers.specstream]
url = "https://api.specstream.ai/mcp"
bearer_token_env_var = "SPECSTREAM_API_KEY"

Cursor

Agrega a ~/.cursor/mcp.json, o .cursor/mcp.json en un proyecto:

{
  "mcpServers": {
    "specstream": {
      "url": "https://api.specstream.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:SPECSTREAM_API_KEY}" }
    }
  }
}

VS Code

Agrega a .vscode/mcp.json. VS Code pide la clave una vez y la mantiene fuera del archivo.

{
  "inputs": [
    { "type": "promptString", "id": "specstream-key", "description": "SpecStream API key", "password": true }
  ],
  "servers": {
    "specstream": {
      "type": "http",
      "url": "https://api.specstream.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:specstream-key}" }
    }
  }
}

Windsurf

Agrega a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "specstream": {
      "serverUrl": "https://api.specstream.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:SPECSTREAM_API_KEY}" }
    }
  }
}

Zed, Cline y Continue

Estos inician un servidor local, así que usa el proxy stdio. Reenvía tu clave desde el entorno y nada más.

pip install specstream-mcp-stdio

Zed, en settings.json:

{
  "context_servers": {
    "specstream": {
      "command": "specstream-mcp-stdio",
      "args": [],
      "env": { "SPECSTREAM_MCP_URL": "https://api.specstream.ai/mcp" }
    }
  }
}

Cline, en cline_mcp_settings.json:

{
  "mcpServers": {
    "specstream": {
      "command": "specstream-mcp-stdio",
      "args": [],
      "env": { "SPECSTREAM_MCP_URL": "https://api.specstream.ai/mcp" }
    }
  }
}

Continue, en .continue/mcpServers/specstream.yaml:

name: SpecStream
version: 1.0.0
schema: v1
mcpServers:
  - name: specstream
    type: stdio
    command: specstream-mcp-stdio
    args: []
    env:
      SPECSTREAM_MCP_URL: https://api.specstream.ai/mcp
      SPECSTREAM_API_KEY: ${{ secrets.SPECSTREAM_API_KEY }}

Inicia Zed y Cline desde un shell donde SPECSTREAM_API_KEY esté configurada. Los agentes que instalan SpecStream para alguien pueden seguir llms-install.md.

Gemini CLI

gemini mcp add --transport http specstream https://api.specstream.ai/mcp \
  --header "Authorization: Bearer $SPECSTREAM_API_KEY"

O en ~/.gemini/settings.json:

{
  "mcpServers": {
    "specstream": {
      "httpUrl": "https://api.specstream.ai/mcp",
      "headers": { "Authorization": "Bearer $SPECSTREAM_API_KEY" }
    }
  }
}

n8n

Instala el nodo comunitario desde Configuración > Nodos comunitarios: n8n-nodes-specstream. Lee una solicitud, muestra la cotización, aprueba el máximo que escribas y devuelve los resultados. Tres flujos de trabajo importables están en integrations/n8n/workflows. Un agente de IA en n8n también puede usar el nodo MCP Client Tool con el endpoint https://api.specstream.ai/mcp, transporte HTTP Streamable y una credencial Bearer.

LangChain

import os
from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "specstream": {
        "transport": "streamable_http",
        "url": "https://api.specstream.ai/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['SPECSTREAM_API_KEY']}"},
    }
})
tools = await client.get_tools()

Un agente completo está en examples/langchain-mcp.

OpenAI Agents SDK

import os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="SpecStream",
    params={
        "url": "https://api.specstream.ai/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['SPECSTREAM_API_KEY']}"},
    },
    cache_tools_list=True,
) as server:
    agent = Agent(name="Researcher", instructions="Use SpecStream for lists.", mcp_servers=[server])
    result = await Runner.run(agent, "Food banks in Texas, with their annual revenue. Show me the price first.")

Un agente completo está en examples/openai-agents-sdk.

Cualquier otro cliente que hable MCP remoto sobre HTTP Streamable funciona con la dirección anterior y un encabezado Authorization: Bearer.

Qué hace el agente, en orden

Nada se gasta hasta que una persona —o un agente dentro de un límite que una persona estableció— apruebe un precio.

compile lee la solicitud y devuelve cómo SpecStream la entendió: el tipo de cosa, las condiciones que cada resultado debe cumplir, los hechos a traer.
quote_capacity_work devuelve el precio y el máximo que el trabajo puede costar. Un precio dura 30 minutos.
authorize_capacity_work aprueba esa cotización exacta, con el máximo en centavos (confirm_max_cents) y un idempotency_key estable, para que un reintento nunca pague dos veces.
get_find muestra el progreso mientras llegan las filas. list_find_rows devuelve resultados con la razón y la fuente de cada hecho.
export_find, share_find y send_to_destination mueven los resultados. Leer, exportar y compartir no cuesta nada.

Cada resultado entregado cuesta 10 centavos, 30 centavos o $1 dependiendo de cuántos hechos lleve. Una búsqueda que no encuentra nada es gratis. Consulta precios.

Las cuatro habilidades en skills/ enseñan a un agente este orden y dónde detenerse y preguntar: compile, review-work, approve-work, continue-work.

SDK y línea de comandos

pip install specstream-client        # Python 3.12+, import specstream_client, command: specstream
npm install @specstream/sdk          # Node 22+
brew tap specstreamai/specstream-tools https://github.com/Specstreamai/specstream-tools
brew install specstream              # the command line

import os
from specstream_client import Client

client = Client(os.environ["SPECSTREAM_API_KEY"])
read = client.compile("Datasets on urban tree canopy published since 2020 under an open license.")
offer = client.quote_capacity_work({
    "ast_hash": read["ast_hash"], "operation": "find",
    "requested_units": read["ast"]["limit"]["max"],
})
print(offer["maximum_cents"], offer["expires_at"])

import { Client } from "@specstream/sdk";

const client = new Client({ apiKey: process.env.SPECSTREAM_API_KEY! });
const read = await client.compile("Datasets on urban tree canopy published since 2020 under an open license.");

Los scripts de trabajo que ejecutan una solicitud de principio a fin están en examples/python-sdk y examples/typescript-sdk.

Acción de GitHub

- uses: Specstreamai/specstream-tools/actions/find-action@v1
  with:
    request: Open tenders on SAM.gov for translation services with a deadline after November 1. Include the buyer and the estimated value.
    api_key: ${{ secrets.SPECSTREAM_API_KEY }}
    confirm_max_usd: "10"

El paso se detiene si el precio está por encima de confirm_max_usd.

Tres solicitudes

Di lo que necesitas como se lo dirías a un colega. Estas provienen de las plantillas de solicitud del producto.

Empresas de software en Alemania con 50 a 500 empleados que estén contratando vendedores. Incluye la oferta de trabajo y el correo de contacto. Una fila por empresa, con su tamaño, la oferta de trabajo de ventas y el correo de contacto que la empresa publicó. Cada fila dice en una línea por qué encaja, con la página de la que proviene cada hecho. Las empresas que SpecStream no pudo confirmar se listan aparte y no cuestan nada.

Licitaciones abiertas en SAM.gov para servicios de traducción con fecha límite después del 1 de noviembre. Incluye el comprador y el valor estimado. Una fila por aviso, con el comprador, el valor estimado, la fecha límite y un enlace al aviso. El código compara la fecha límite con la fecha que diste.

Herramientas de línea de comandos de Rust en GitHub con más de 1,000 estrellas, con push en el último mes, bajo licencia MIT o Apache. Una fila por repositorio, con sus estrellas, último push y licencia. El código compara las estrellas y la fecha con tus números, y cada fila enlaza al repositorio.

La lectura va a donde viven esas cosas: registros y API oficiales, mapas y directorios, bolsas de trabajo, índices de investigación, noticias y el sitio propio de cada resultado. SpecStream lee en el momento en que preguntas.

Documentación y soporte

Primeros pasos, API, SDK, MCP
Precios
Guía de agente y llms.txt
Soporte: support@specstream.ai
Informes de seguridad: consulta SECURITY.md

Licencia

MIT. Consulta LICENSE. El servicio SpecStream se rige por sus términos.