Sapiom
97 cloud-service tools via one MCP server. Scrape, compute, store, search, generate — pay per use, no vendor accounts.
Quick Setup — MCP Server (Recommended)
# Claude Code CLI
claude mcp add sapiom --transport http https://api.sapiom.ai/v1/mcp
{
"mcpServers": {
"sapiom": {
"type": "http",
"url": "https://api.sapiom.ai/v1/mcp"
}
}
}
Browser auth is used automatically. To use an API key instead, add --header "Authorization:Bearer YOUR_KEY" or set the headers field. Get a key at https://app.sapiom.ai/settings.
When to Use
- Scrape & extract web content, crawl sites, take screenshots
- Run code in cloud sandboxes (Node, Python, Go, Rust) with file I/O and process management
- Store data in Redis, Vector DB, Search Index, or ephemeral Postgres
- Search the web with Linkup (fast) or You.com (thorough)
- Generate media — images (Fal.ai), speech (ElevenLabs), sound effects
- Send messages via queues, schedules, and pub/sub
Building an agent? Use sapiom-agent-builder. Just deploying code? Use sapiom-deploy.
Available Tools
Getting Started (2)
| Tool | Description |
|---|
sapiom_status | Check MCP session auth and tenant context |
tool_discover | Find the right tool by keyword (free) |
Scraping & Browser (9) — details
| Tool | Description |
|---|
sapiom_fetch | Fetch clean main content from a URL as markdown |
sapiom_screenshot | Capture a webpage screenshot (PNG URL) |
sapiom_scrape | Advanced scrape with format options and selectors |
sapiom_crawl | Crawl an entire website (async, returns job ID) |
sapiom_crawl_status | Check crawl job status and get results |
sapiom_map | Discover all URLs on a site (fast sitemap) |
sapiom_extract | Extract structured data with prompt + schema |
sapiom_extract_status | Check extract job status and get results |
sapiom_site_search | Search within a specific website's content |
Compute (31) — details
| Tool | Description |
|---|
sapiom_run | Run code snippet in the cloud (Node/Python/Go/Rust) |
sapiom_run_list | List recent code runs |
sapiom_run_get | Get run result by ID |
sapiom_sandbox_create | Create a persistent cloud sandbox |
sapiom_sandbox_list | List active sandboxes |
sapiom_sandbox_get | Get sandbox details |
sapiom_sandbox_delete | Delete a sandbox |
sapiom_sandbox_extend | Extend sandbox lifetime |
sapiom_sandbox_exec | Execute a command in a sandbox |
sapiom_sandbox_deploy | Deploy sandbox as a persistent service |
sapiom_sandbox_write_file | Write a file to a sandbox |
sapiom_sandbox_read_file | Read a file from a sandbox |
sapiom_sandbox_list_files | List files in a sandbox directory |
sapiom_sandbox_delete_file | Delete a file from a sandbox |
sapiom_sandbox_process_logs | Get process stdout/stderr logs |
sapiom_sandbox_process_list | List running processes in a sandbox |
sapiom_sandbox_process_get | Get process details by PID |
sapiom_sandbox_process_stop | Gracefully stop a process |
sapiom_sandbox_process_kill | Force-kill a process |
sapiom_sandbox_preview_create | Create a public preview URL for a port |
sapiom_sandbox_preview_list | List active preview URLs |
sapiom_sandbox_preview_delete | Delete a preview URL |
sapiom_sandbox_ports | List open ports in a sandbox |
sapiom_job_deploy | Deploy a scheduled/triggered job |
sapiom_job_list | List deployed jobs |
sapiom_job_get | Get job details |
sapiom_job_update | Update job config |
sapiom_job_delete | Delete a job |
sapiom_job_trigger | Manually trigger a job execution |
sapiom_job_list_executions | List job execution history |
sapiom_job_get_execution | Get execution result by ID |
| Tool | Description |
|---|
sapiom_redis_create | Create a serverless Redis database |
sapiom_redis_create_fixed | Create a fixed-size Redis database |
sapiom_redis_list | List Redis databases |
sapiom_redis_delete | Delete a Redis database |
sapiom_redis_update | Rename a Redis database |
sapiom_redis_command | Execute any Redis command |
sapiom_vector_create | Create a vector index |
sapiom_vector_list | List vector indexes |
sapiom_vector_delete | Delete a vector index |
sapiom_vector_update | Update vector index settings |
sapiom_vector_upsert | Upsert vectors with metadata |
sapiom_vector_query | Query vectors by similarity |
sapiom_searchindex_create | Create a full-text search index |
sapiom_searchindex_list | List search indexes |
sapiom_searchindex_delete | Delete a search index |
sapiom_searchindex_update | Update search index schema |
sapiom_searchindex_upsert | Upsert documents into search index |
sapiom_searchindex_query | Query a search index |
sapiom_database_create | Provision an ephemeral Neon Postgres database |
sapiom_database_price | Get Postgres price estimate (free) |
sapiom_database_list | List active Postgres databases |
sapiom_database_get | Get Postgres database details + connection URI |
sapiom_database_delete | Delete a Postgres database |
Messaging (16) — details
| Tool | Description |
|---|
sapiom_message_publish | Publish a message to a URL endpoint |
sapiom_message_enqueue | Enqueue a message to a named queue |
sapiom_message_batch | Send multiple messages in one call |
sapiom_message_get | Get message delivery status |
sapiom_message_cancel | Cancel a pending message |
sapiom_schedule_create | Create a recurring schedule (cron) |
sapiom_schedule_list | List schedules |
sapiom_schedule_get | Get schedule details |
sapiom_schedule_delete | Delete a schedule |
sapiom_schedule_pause | Pause a schedule |
sapiom_schedule_resume | Resume a paused schedule |
sapiom_queue_list | List message queues |
sapiom_queue_get | Get queue details |
sapiom_queue_delete | Delete a queue |
sapiom_queue_pause | Pause a queue |
sapiom_queue_resume | Resume a paused queue |
| Tool | Description |
|---|
sapiom_search | Web search via Linkup — AI-synthesised answer with sources |
sapiom_deep_search | Web search via You.com — formatted web + news results |
AI Models (2) — details
| Tool | Description |
|---|
sapiom_chat | Send a prompt to any LLM via OpenRouter |
sapiom_list_models | List available LLM models and pricing |
| Tool | Description |
|---|
sapiom_text_to_speech | Convert text to speech (ElevenLabs) |
sapiom_sound_effects | Generate sound effects from description |
sapiom_list_voices | List available ElevenLabs voices (free) |
| Tool | Description |
|---|
sapiom_generate_image | Generate images from text prompt (Fal.ai FLUX) |
| Tool | Description |
|---|
sapiom_verify_send | Send a verification code via SMS |
sapiom_verify_check | Check a 6-digit verification code |
Governance (6) — details
| Tool | Description |
|---|
sapiom_create_agent | Register a named agent for tracking |
sapiom_list_agents | List registered agents |
sapiom_create_spending_rule | Create spending/usage limits |
sapiom_list_spending_rules | List spending rules |
sapiom_create_transaction_api_key | Create a new API key |
sapiom_authenticate | Get auth flow instructions |
Recipes
1. Research a Topic
sapiom_search (quick answer) → sapiom_deep_search (more results) → sapiom_fetch (read full articles) → sapiom_chat (summarize findings)
2. Monitor a Page for Changes
sapiom_scrape (get content) → sapiom_redis_command (store hash, compare with previous) → sapiom_message_publish (alert on change) → sapiom_schedule_create (run every hour)
3. Build a Knowledge Base
sapiom_crawl (crawl docs site) → sapiom_crawl_status (get pages) → sapiom_vector_upsert (store embeddings) → sapiom_vector_query (semantic search)
4. Run & Deploy Code
sapiom_run (test code snippet) → sapiom_sandbox_create (persistent environment) → sapiom_sandbox_exec (iterate) → sapiom_job_deploy (schedule for production)
5. Generate Media
sapiom_generate_image (create visuals) + sapiom_text_to_speech (narration) + sapiom_sound_effects (background audio)
Tips
tool_discover finds the right tool by keyword — it's free, use it when unsure- Pass
agentName on gateway calls for per-agent spend tracking sapiom_search (Linkup) = fast AI answer; sapiom_deep_search (You.com) = more raw results- Provision resources before using them:
sapiom_redis_create, sapiom_vector_create, sapiom_database_create - Set spending rules via
sapiom_create_spending_rule before deploying autonomous agents sapiom_database_price is free — always check cost before creating a Postgres DB
SDK Access (Direct HTTP)
For direct HTTP calls without MCP, use the SDK:
npm install @sapiom/fetch
# or: npm install @sapiom/axios axios
const { createFetch } = require("@sapiom/fetch");
const safeFetch = createFetch({ apiKey: process.env.SAPIOM_API_KEY });
const res = await safeFetch("https://linkup.services.sapiom.ai/v1/search", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ q: "quantum computing", depth: "standard", outputType: "sourcedAnswer" }),
});
Python/curl: use standard HTTP with X-402-Payment header — see reference files for gateway URLs.
Troubleshooting
| Issue | Cause | Fix |
|---|
| 402 Payment Required | Insufficient balance or spending rule hit | Top up at app.sapiom.ai or check sapiom_list_spending_rules |
| MCP connection refused | Wrong URL or auth issue | Verify URL is https://api.sapiom.ai/v1/mcp; try browser auth or check API key |
tool_discover returns nothing | Too vague query | Use specific keywords: "scrape", "redis", "image", "search" |
| Scrape returns empty | JS-rendered page needs wait time | Use sapiom_scrape with waitFor: 3000 instead of sapiom_fetch |
| "Resource not found" | Using data tool before provisioning | Create first: sapiom_redis_create, sapiom_vector_create, etc. |
| Database URI missing | DB still provisioning | Wait a few seconds, then sapiom_database_get to check status |
References
Full docs: https://docs.sapiom.ai (append .md to any URL for raw markdown)
