MCP-Saptiva is a Model Context Protocol server for interacting with Saptiva AI's models and tools through Claude Code.
Chat (
saptiva_chat): Converse with Saptiva AI models — Turbo (fast), Cortex (reasoning), Ops (RAG/web search), Legacy (tool-compatible), and KAL (Mexican legal context) — with configurable parameters like temperature, max tokens, and top-p.Step-by-Step Reasoning (
saptiva_reason): Use Saptiva Cortex for complex math, logic, and multi-step analysis with visible chain-of-thought output.OCR (
saptiva_ocr): Extract text from images via URL or base64 encoding, useful for document processing and receipt scanning.Text Embeddings (
saptiva_embed): Generate semantic embedding vectors for similarity search, clustering, and RAG applications.Batch Embeddings (
saptiva_batch_embed): Efficiently generate embeddings for multiple texts in a single call.List Models (
saptiva_list_models): Retrieve all available models with their capabilities, descriptions, and pricing.Help & Docs (
saptiva_help): Access guides, examples, cURL commands, and Saptiva Agents SDK information across various topics.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-Saptivause Saptiva Cortex to solve this complex logic puzzle"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP-Saptiva
MCP (Model Context Protocol) server para interactuar con los LLMs y herramientas de Saptiva AI.
Instalación para Claude Code
Paso 1: Obtén tu API Key
Ve a https://lab.saptiva.com/ y copia tu API key.
Paso 2: Configura Claude Code
Abre tu terminal y ejecuta:
Pega esta configuración (reemplaza TU_API_KEY):
Paso 3: Reinicia Claude Code
Cierra y vuelve a abrir Claude Code. El MCP estará disponible.
Paso 4: Verifica que funciona
En Claude Code, pregunta:
Claude debería usar saptiva_list_models y mostrarte los modelos.
Herramientas Disponibles
Herramienta | Descripción |
| Chat con cualquier modelo de Saptiva |
| Razonamiento paso a paso con Cortex |
| Extraer texto de imágenes |
| Generar embeddings de texto |
| Embeddings de múltiples textos |
| Ver modelos disponibles y precios |
| Documentación y ejemplos |
Temas de Ayuda
Usa saptiva_help con estos temas:
Modelos Disponibles
Modelo | Ideal para | Precio (por M tokens) |
Saptiva Turbo | Respuestas rápidas | $0.20 / $0.60 |
Saptiva Cortex | Razonamiento complejo | $0.30 / $0.80 |
Saptiva Ops | RAG, búsqueda web | $0.20 / $0.60 |
Saptiva OCR | Extracción de texto de imágenes | $0.15 / $0.50 |
Saptiva Embed | Vectorización semántica | $0.01 / - |
Saptiva KAL | Contexto legal México | $0.20 / $0.60 |
Ejemplos de Uso en Claude Code
Chat simple
Razonamiento
OCR
Embeddings
Instalación Local (Desarrollo)
Si quieres modificar el MCP:
Para usar tu versión local, cambia la config:
Links
Saptiva Agents SDK - Framework Python para agentes
License
MIT