Remote MCP Server

Sapiom ships two MCP servers. This page covers the remote MCP — a hosted server at https://api.sapiom.ai/v1/mcp that exposes every Sapiom capability as a direct sapiom_* tool. Use it when you want to call one capability once (search the web, generate an image, run a snippet) without authoring a workflow.

Which MCP do I want?

Building something multi-step, scheduled, or deployable? Use the authoring MCP (@sapiom/mcp) — it scaffolds, tests, and deploys workflows, and inside a step you call capabilities via the typed ctx.sapiom.* client.

Just need to call a capability directly, right now? Use the remote MCP on this page. Both can be installed side by side.

---

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.

---

What’s available

The remote MCP exposes 130 tools — one family per capability. Every capability in the catalog is reachable here as an sapiom_* tool:

Capability	Example tools
Search the Web	sapiom_search, sapiom_deep_search
Web Scraping	sapiom_scrape, sapiom_crawl, sapiom_map, sapiom_extract
AI Model Access	sapiom_chat, sapiom_list_models
Generate Images	sapiom_generate_image
Audio Services	sapiom_text_to_speech, sapiom_sound_effects, sapiom_list_voices
Browser Automation	sapiom_fetch, sapiom_screenshot, sapiom_browser_session_create
Compute	sapiom_run, sapiom_sandbox_create, sapiom_job_deploy
Data	sapiom_redis_*, sapiom_vector_*, sapiom_searchindex_*, sapiom_database_*
Messaging	sapiom_message_publish, sapiom_schedule_create
File Storage	sapiom_file_upload, sapiom_file_download
Repositories	sapiom_git_create_repo, sapiom_git_list_repos
Email & Enrichment	sapiom_email_find, sapiom_domain_search, sapiom_company_enrichment
Domains & DNS	sapiom_domains_search, sapiom_domains_buy, sapiom_dns_create_record
Verify Users	sapiom_verify_send, sapiom_verify_check
GitHub Export	sapiom_github_export
Governance	sapiom_create_agent, sapiom_create_spending_rule, sapiom_create_transaction_api_key

Each capability page’s Direct (remote MCP) tab shows the exact tool name and a call example.

Tip

Start with tool_discover — describe your goal and it returns ranked tool recommendations with usage examples. Free tools like sapiom_status, sapiom_list_voices, and sapiom_list_models cost nothing to call.

---

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

Browse Capabilities Every capability, with a Direct (remote MCP) / SDK / Workflow tab and full pricing.

Authoring MCP Build multi-step, deployable workflows with @sapiom/mcp instead.