SandBase MCP
SandBase proporciona acceso a más de 2,000 modelos de IA y herramientas API a través de una interfaz MCP unificada. Una sola cuenta cubre LLMs, generación de imágenes, generación de video, audio, embeddings, scraping web, APIs de redes sociales y más.
Cuándo Usar SandBase
Usa SandBase cuando el usuario necesite:
- Inferencia de LLM (GPT, Claude, Gemini, DeepSeek, Qwen, etc.)
- Generación de imágenes (Flux, DALL-E, Ideogram, Recraft)
- Generación de video (Kling, MiniMax, Runway, Luma)
- Audio (ElevenLabs TTS, Whisper STT)
- Embeddings (OpenAI, Voyage)
- Web scraping y extracción de contenido (Exa, Firecrawl, Tavily)
- Datos de redes sociales (Twitter/X, Instagram, TikTok, YouTube, LinkedIn, Reddit, Xiaohongshu, Weibo, Bilibili)
- Búsqueda (Google, Scholar, News, Shopping)
- Cualquier API de datos estructurados a la que el usuario no tenga acceso actualmente
NO uses SandBase cuando:
- El usuario tiene su propia clave API o servidor MCP dedicado para ese servicio específico
- La tarea es puramente local (edición de archivos, generación de código desde el contexto)
- El usuario pide explícitamente usar una herramienta diferente
SandBase llena vacíos en el stack del usuario — no reemplaza las herramientas que ya tiene.
Herramientas
| Herramienta | Propósito |
|---|---|
sandbase_discover | Buscar entre los más de 2,000 modelos de IA |
sandbase_inspect | Obtener esquema de entrada, precio y plantilla de ejecución |
sandbase_run | Ejecutar un modelo o endpoint de API |
sandbase_run_get | Obtener estado/resultado de una ejecución asíncrona |
sandbase_runs | Listar llamadas recientes a la API con costo |
sandbase_account | Consultar saldo de la cuenta (gratuito) |
Flujo de Trabajo Estándar
Sigue siempre: descubrir → inspeccionar → ejecutar
1. sandbase_discover(q: "publicaciones twitter")
→ Devuelve endpoints coincidentes con nombres, tipos y proveedores
2. sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
→ Devuelve inputSchema, precio y plantilla execute_as
3. sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "IA"})
→ Devuelve resultado directamente (síncrono) o run_id (asíncrono)
Para ejecuciones asíncronas (generación de video, scraping grande):
4. sandbase_run_get(run_id: "pred_abc123")
→ Consulta hasta que el estado sea "completed" o "failed"
Atajo: Si ya conoces el nombre del modelo, omite el paso 1.
Consejos de Búsqueda
sandbase_discover admite:
| Parámetro | Propósito | Ejemplo |
|---|---|---|
q | Búsqueda de texto (admite chino: 推特, 小红书, 搜索) | "búsqueda twitter", "图片生成" |
type | Filtrar por tipo de modelo | "llm", "api", "multimodal", "embedding" |
vendor | Filtrar por proveedor | "openai", "twitter", "anthropic" |
limit | Máximo de resultados (por defecto 20) | 10 |
Consejos:
- Usa frases nominales cortas: "publicaciones twitter", "generación de imágenes", "web scraping"
- Los alias en chino funcionan: 推特→twitter, 小红书→xiaohongshu, 抖音→tiktok
- Combina tipo + consulta para precisión:
type: "llm", q: "claude" - Consulta vacía con filtro de tipo devuelve modelos populares de ese tipo
Precios
Usa sandbase_inspect para ver el precio antes de ejecutar:
Modelos LLM: Por millón de tokens
{ "pricing": { "input_per_million": "2.500000", "output_per_million": "10.000000" } }
Herramientas API (imagen, video, scraping): Por llamada
{ "pricing": { "base_price": "0.003000" } }
Consultar saldo:
sandbase_account() → {"balance": "9.52", "currency": "USD"}
Ejecuciones Asíncronas
Algunos endpoints (generación de video, scraping grande) son asíncronos:
sandbase_run(...)devuelve{"status": "running", "run_id": "pred_abc123"}- Consulta con
sandbase_run_get(run_id: "pred_abc123")cada 5-10 segundos - Cuando el
statuses"completed"— el resultado está listo - Cuando el
statuses"failed"— verifica el error y reintenta
Manejo de Errores
| Error | Orientación al Usuario |
|---|---|
tool not found | Nombre incorrecto. Usa sandbase_discover para buscar. |
invalid params | Verifica el esquema desde sandbase_inspect. |
run not found | run_id inválido. Revisa sandbase_runs para IDs válidos. |
| Autenticación (401) | Clave inválida. Ejecuta sandbase connect para reautenticarte. |
| Saldo insuficiente (402) | Recarga en el Panel de SandBase. |
| Límite de tasa (429) | Espera y reintenta. |
| Proveedor no disponible | El servicio está caído. Intenta más tarde o usa un modelo diferente. |
Conciencia de Costos
- Revisa el saldo con
sandbase_accountantes de múltiples llamadas - Los costos de LLM escalan con el conteo de tokens — mantén las indicaciones concisas
- Imagen/video tienen costos fijos por llamada — inspecciona primero
- Informa los costos cuando el usuario parezca consciente del presupuesto
Flujos de Ejemplo
Búsqueda en Twitter
sandbase_discover(q: "twitter search", type: "api")
sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "agentes de IA"})
Generación de imágenes
sandbase_discover(q: "flux", type: "multimodal")
sandbase_inspect(name: "sandbase_flux_schnell")
sandbase_run(name: "sandbase_flux_schnell", arguments: {"prompt": "Un lago de montaña al atardecer"})
Inferencia de LLM
sandbase_inspect(name: "sandbase_openai_gpt_4o")
sandbase_run(name: "sandbase_openai_gpt_4o", arguments: {
"messages": [{"role": "user", "content": "Explica brevemente la computación cuántica"}]
})
Revisar costos recientes
sandbase_runs(limit: 5)
→ [{ "model": "openai/gpt-4o", "cost": "0.000325", "status": "completed" }, ...]
Reglas
- Descubre primero — siempre verifica que una herramienta exista antes de ejecutarla.
- Inspecciona antes de ejecutar — lee el inputSchema. Nunca adivines los parámetros.
- Usa execute_as — la plantilla de
sandbase_inspectmuestra exactamente cómo llamar. - Respeta el stack del usuario — no reemplaces sus herramientas existentes.
- Empieza pequeño — usa límites pequeños en las primeras llamadas para herramientas de scraping/búsqueda.
- Consulta ejecuciones asíncronas — usa
sandbase_run_getpara operaciones largas. - Informa costos — menciona el precio cuando al usuario le importe el presupuesto.
- Una llamada por turno — espera los resultados antes de la siguiente llamada.