MCP-Saptiva
An MCP (Model Context Protocol) server for interacting with Saptiva AI's LLMs and tools.
Features
- Chat Completions: Access Saptiva's various LLM models
- Reasoning: Chain-of-thought reasoning with Saptiva Cortex
- OCR: Extract text from images using Saptiva OCR
- Embeddings: Generate semantic embeddings for text
- Help System: Built-in documentation and examples
Available Tools
| Tool | Description |
|---|---|
saptiva_chat | Send chat completion requests to Saptiva AI models |
saptiva_reason | Complex reasoning with chain-of-thought (Cortex model) |
saptiva_ocr | Extract text from images using vision model |
saptiva_embed | Generate semantic embeddings for text |
saptiva_batch_embed | Batch embedding generation for multiple texts |
saptiva_list_models | List all available models with pricing |
saptiva_help | Built-in documentation and examples |
Help Topics
Use saptiva_help with these topics:
| Topic | Description |
|---|---|
quick_start | Getting started with Saptiva API |
chat_example | Complete chat request/response example |
reasoning_example | Using Cortex for reasoning |
ocr_example | Extracting text from images |
embedding_example | Generating embeddings |
all_tools | List of all available tools |
curl_examples | cURL commands for terminal |
agents_sdk | Saptiva Agents SDK documentation |
Available Prompts
| Prompt | Description |
|---|---|
code_review | Review code for bugs and improvements |
explain_concept | Explain technical concepts at different levels |
write_documentation | Generate documentation for code |
debug_help | Help debug errors and issues |
mexican_legal | Mexican legal/regulatory questions (uses KAL model) |
Available Models
| Model | Best For | Tools Support | Pricing (per M tokens) |
|---|---|---|---|
| Saptiva Turbo | Fast responses, high concurrency | Yes | $0.20 / $0.60 |
| Saptiva Cortex | Reasoning tasks with chain-of-thought | Yes | $0.30 / $0.80 |
| Saptiva Ops | Complex cases, RAG, web search | No | $0.20 / $0.60 |
| Saptiva Legacy | Compatibility with legacy tools | Yes | $0.20 / $0.60 |
| Saptiva OCR | Document text extraction, vision | No | $0.15 / $0.50 |
| Saptiva Embed | Semantic vectorization | N/A | $0.01 / - |
| Saptiva KAL | Mexico-specific context | Yes | $0.20 / $0.60 |
Installation
npm install
npm run build
Configuration
-
Copy
.env.exampleto.env:cp .env.example .env -
Add your Saptiva API key to
.env:SAPTIVA_API_KEY=your_api_key_here -
Get your API key from Saptiva Lab
Usage with Claude Desktop
Add to your Claude Desktop MCP configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"saptiva": {
"command": "node",
"args": ["/path/to/MCP-Saptiva/dist/index.js"],
"env": {
"SAPTIVA_API_KEY": "your_api_key_here"
}
}
}
}
Quick Examples
Chat
{
"model": "Saptiva Turbo",
"messages": [
{"role": "user", "content": "¿Qué es Python?"}
]
}
Reasoning
{
"question": "Si tengo 5 manzanas y como 2, ¿cuántas quedan?",
"max_tokens": 500
}
OCR
{
"image_url": "https://example.com/document.png",
"prompt": "Extrae todo el texto de esta imagen"
}
Embeddings
{
"text": "Texto para convertir a vector"
}
Resources
The server exposes two resources:
saptiva://models- List of all models with capabilitiessaptiva://pricing- Pricing information for all models
Development
# Install dependencies
npm install
# Build
npm run build
# Run tests
node test-comprehensive.mjs
Related Projects
- Saptiva Agents SDK - Python framework for building AI agents
- PyPi Package -
pip install saptiva-agents
Links
License
MIT