MCP Server Setup

Sapiom’s remote MCP server gives AI coding tools direct access to 77 tools — web search, AI models, browser automation, audio generation, image creation, compute (jobs & sandboxes), databases (Redis, Vector, Search, Postgres), messaging (queues & schedules), phone verification, and governance — over HTTP.

---

Setup

Connect your AI client to Sapiom’s remote MCP server:

Claude Code CLI

claude mcp add sapiom --transport http https://api.sapiom.ai/v1/mcp

Claude Code Config

Add to your Claude Code settings file (~/.claude/settings.json or project .claude/settings.json):

{
  "mcpServers": {
    "sapiom": {
      "transport": "http",
      "url": "https://api.sapiom.ai/v1/mcp"
    }
  }
}

Cursor / Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "sapiom": {
      "transport": "http",
      "url": "https://api.sapiom.ai/v1/mcp"
    }
  }
}

Tip

If your platform requires explicit authentication, add --header "x-api-key: YOUR_API_KEY" (CLI) or a "headers": { "x-api-key": "YOUR_API_KEY" } block (JSON). Get a key at app.sapiom.ai/settings.

---

Available Tools

Category	Tool	Description
Discovery	tool_discover	Find the best tools for your objective — describe a goal, get ranked recommendations
Search	sapiom_search	Web search via Linkup with AI-synthesised answers and source citations
Search	sapiom_deep_search	Web + news results via You.com — use with sapiom_search for broader coverage
Browser	sapiom_fetch	Fetch and extract webpage content as markdown
Browser	sapiom_screenshot	Capture a webpage screenshot (returns expiring PNG URL)
Audio	sapiom_text_to_speech	Convert text to speech via ElevenLabs (returns mp3 URL)
Audio	sapiom_sound_effects	Generate sound effects from a text description (returns mp3 URL)
Audio	sapiom_list_voices	List available ElevenLabs voices and IDs (free)
AI Models	sapiom_chat	Send a prompt to an LLM via OpenRouter (GPT-4o, Claude, etc.)
AI Models	sapiom_list_models	List available LLM models and pricing (free)
Image	sapiom_generate_image	Generate images from text prompts via Fal.ai (FLUX Schnell/Dev/Pro)
Verify	sapiom_verify_send	Send SMS verification code to a US phone number
Verify	sapiom_verify_check	Check a 6-digit verification code
Governance	sapiom_create_agent	Register a named agent for transaction tracking
Governance	sapiom_list_agents	List registered agents
Governance	sapiom_create_spending_rule	Create spending/usage limits (cost caps, rate limits)
Governance	sapiom_list_spending_rules	List spending rules
Governance	sapiom_create_transaction_api_key	Create a scoped API key (shown once — store securely)
Status	sapiom_status	Check authentication and tenant context (free)
Auth	sapiom_authenticate	Get authentication flow instructions (browser + device code)
Compute	sapiom_job_deploy	Deploy a serverless batch job
Compute	sapiom_job_list	List all deployed jobs
Compute	sapiom_job_get	Get status of a deployed job
Compute	sapiom_job_update	Update an existing job
Compute	sapiom_job_delete	Delete a deployed job
Compute	sapiom_job_trigger	Trigger a job execution with task payloads
Compute	sapiom_job_list_executions	List past executions for a job
Compute	sapiom_job_get_execution	Get detailed execution status and results
Compute	sapiom_sandbox_create	Create a persistent cloud sandbox
Compute	sapiom_sandbox_list	List all active sandboxes
Compute	sapiom_sandbox_get	Get sandbox status and details
Compute	sapiom_sandbox_delete	Delete a sandbox
Compute	sapiom_sandbox_extend	Extend sandbox lifetime
Compute	sapiom_sandbox_exec	Execute a command in a sandbox
Compute	sapiom_sandbox_process_logs	Get process stdout/stderr logs
Compute	sapiom_sandbox_list_files	List files in a sandbox
Compute	sapiom_sandbox_read_file	Read a file from a sandbox
Compute	sapiom_sandbox_write_file	Write a file to a sandbox
Compute	sapiom_sandbox_deploy	Deploy source files to a sandbox
Database	sapiom_redis_create	Create a Redis database
Database	sapiom_redis_list	List Redis databases
Database	sapiom_redis_delete	Delete a Redis database
Database	sapiom_redis_update	Update/extend a Redis database
Database	sapiom_redis_command	Execute Redis commands
Database	sapiom_vector_create	Create a Vector index
Database	sapiom_vector_list	List Vector indexes
Database	sapiom_vector_delete	Delete a Vector index
Database	sapiom_vector_update	Update/extend a Vector index
Database	sapiom_vector_upsert	Upsert vectors
Database	sapiom_vector_query	Query vectors by similarity
Database	sapiom_searchindex_create	Create a Search index
Database	sapiom_searchindex_list	List Search indexes
Database	sapiom_searchindex_delete	Delete a Search index
Database	sapiom_searchindex_update	Update/extend a Search index
Database	sapiom_searchindex_upsert	Upsert documents into index
Database	sapiom_searchindex_query	Query a Search index
Database	sapiom_database_create	Provision ephemeral Postgres database
Database	sapiom_database_price	Get Postgres price estimate (free)
Database	sapiom_database_list	List active Postgres databases
Database	sapiom_database_get	Get database details and connection URI
Database	sapiom_database_delete	Delete a Postgres database
Messaging	sapiom_message_publish	Publish a message to a URL
Messaging	sapiom_message_enqueue	Enqueue a message to a named queue
Messaging	sapiom_message_batch	Batch publish messages
Messaging	sapiom_message_get	Get message delivery status
Messaging	sapiom_message_cancel	Cancel a pending message
Messaging	sapiom_schedule_create	Create a cron schedule
Messaging	sapiom_schedule_list	List schedules
Messaging	sapiom_schedule_get	Get schedule details
Messaging	sapiom_schedule_delete	Delete a schedule
Messaging	sapiom_schedule_pause	Pause a schedule
Messaging	sapiom_schedule_resume	Resume a schedule
Messaging	sapiom_queue_list	List queues
Messaging	sapiom_queue_get	Get queue details
Messaging	sapiom_queue_delete	Delete a queue
Messaging	sapiom_queue_pause	Pause a queue
Messaging	sapiom_queue_resume	Resume a queue

Tip

Start with tool_discover — describe your goal and it recommends the best tools with usage examples.

---

Troubleshooting

”Unauthorized” or 401 errors

Verify your API key is correct and included in the x-api-key header. Get a new key at app.sapiom.ai/settings.

Tools not appearing

Restart your AI client after adding the MCP server configuration. Verify the URL is exactly https://api.sapiom.ai/v1/mcp.

Timeout errors

Some tools (image generation, deep search, text-to-speech) may take 15–30 seconds. If timeouts persist, try simpler inputs or check service status.

---

Next Steps

Capabilities Deep-dive into each service: pricing, examples, full parameter details

Agent Frameworks Programmatic integrations for LangChain and other frameworks