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:
# Crear el directorio si no existe
mkdir -p ~/.claude
# Crear/editar el archivo de configuración
nano ~/.claude/settings.jsonPega esta configuración (reemplaza TU_API_KEY):
{
"mcpServers": {
"saptiva": {
"command": "npx",
"args": ["-y", "github:saptiva-ai/MCP-Saptiva"],
"env": {
"SAPTIVA_API_KEY": "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:
¿Qué modelos de Saptiva tengo disponibles?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:
quick_start → Inicio rápido
chat_example → Ejemplo de chat completo
reasoning_example → Usar Cortex para razonamiento
ocr_example → Extraer texto de imágenes
embedding_example → Generar embeddings
all_tools → Lista de herramientas
curl_examples → Comandos cURL
agents_sdk → Saptiva Agents SDK (Python)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
Pregúntale a Saptiva Turbo: ¿Cuál es la capital de Francia?Razonamiento
Usa saptiva_reason para resolver: Si tengo 5 manzanas y como 2, ¿cuántas quedan?OCR
Extrae el texto de esta imagen: [URL de imagen]Embeddings
Genera el embedding de "Inteligencia artificial"Instalación Local (Desarrollo)
Si quieres modificar el MCP:
# Clonar
git clone https://github.com/saptiva-ai/MCP-Saptiva.git
cd MCP-Saptiva
# Instalar y construir
npm install
npm run build
# Configurar API key
cp .env.example .env
# Edita .env y agrega tu SAPTIVA_API_KEY
# Probar
node test-comprehensive.mjsPara usar tu versión local, cambia la config:
{
"mcpServers": {
"saptiva": {
"command": "node",
"args": ["/ruta/a/MCP-Saptiva/dist/index.js"],
"env": {
"SAPTIVA_API_KEY": "TU_API_KEY"
}
}
}
}Links
Saptiva Agents SDK - Framework Python para agentes
License
MIT
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.