# Remote MCP Server

Call any Sapiom capability directly from your AI client over HTTP — no workflow to author. The remote MCP exposes every gateway service as an sapiom_* tool.

## Navigation

**Getting Started:** [All You Need](/index.md) | [Getting Started](/introduction.md) | [How Sapiom Works](/how-it-works.md) | [Quick Start](/quick-start.md) | [Using Services](/using-services.md) | [For AI Tools](/for-agents.md)  
**Capabilities:** [Overview](/capabilities.md) | [Verify Users](/capabilities/verify.md) | [Search the Web](/capabilities/search.md) | [AI Model Access](/capabilities/ai-models.md) | [Generate Images](/capabilities/images.md) | [Audio Services](/capabilities/audio.md) | [Browser Automation](/capabilities/browser.md)  
**Integration / Agent Frameworks:** [Overview](/integration/agent-frameworks.md) | [LangChain](/integration/agent-frameworks/langchain.md) | [LangChain Classic](/integration/agent-frameworks/langchain-classic.md)  
**Integration / HTTP Clients:** [Overview](/integration/http-clients.md) | [Axios](/integration/http-clients/axios.md) | [Fetch](/integration/http-clients/fetch.md) | [Node.js HTTP](/integration/http-clients/node-http.md)  
**Governance:** [Overview](/governance.md) | [Setting Up Rules](/governance/rules.md) | [Agents & Identity](/governance/agents.md) | [Activity](/governance/activity.md)  
**Reference / API Reference:** [Introduction](/api-reference/introduction.md)  
**Reference / API Reference / Endpoints:** [Agents Endpoints](/api-reference/endpoints/agents.md) | [Get agent by ID](/api-reference/endpoints/agents/v1-agents-by-id-get.md) | [Update agent](/api-reference/endpoints/agents/v1-agents-by-id-patch.md) | [List all agents](/api-reference/endpoints/agents/v1-agents-get.md) | [Create a new agent](/api-reference/endpoints/agents/v1-agents-post.md) | [API Endpoints](/api-reference/endpoints.md) | [Get Sapiom payment JWKS](/api-reference/endpoints/other/.well-known-sapiom-jwks.json-get.md) | [Analytics Endpoints](/api-reference/endpoints/other.md) | [Get analytics chart](/api-reference/endpoints/other/v1-analytics-chart-get.md) | [Get analytics leaderboards](/api-reference/endpoints/other/v1-analytics-leaderboards-get.md) | [Get analytics summary](/api-reference/endpoints/other/v1-analytics-summary-get.md) | [Rules Endpoints](/api-reference/endpoints/rules.md) | [Get rule by ID](/api-reference/endpoints/rules/v1-spending-rules-by-id-get.md) | [Update a rule](/api-reference/endpoints/rules/v1-spending-rules-by-ruleId-put.md) | [List all rules](/api-reference/endpoints/rules/v1-spending-rules-get.md) | [Create a new rule](/api-reference/endpoints/rules/v1-spending-rules-post.md) | [Transactions Endpoints](/api-reference/endpoints/transactions.md) | [Complete a transaction](/api-reference/endpoints/transactions/v1-transactions-by-transactionId-complete-post.md) | [List transaction costs](/api-reference/endpoints/transactions/v1-transactions-by-transactionId-costs-get.md) | [Add cost to transaction](/api-reference/endpoints/transactions/v1-transactions-by-transactionId-costs-post.md) | [Add facts to transaction](/api-reference/endpoints/transactions/v1-transactions-by-transactionId-facts-post.md) | [Get transaction details](/api-reference/endpoints/transactions/v1-transactions-by-transactionId-get.md) | [Reauthorize a transaction with x402 payment data](/api-reference/endpoints/transactions/v1-transactions-by-transactionId-reauthorize-post.md) | [List transactions](/api-reference/endpoints/transactions/v1-transactions-get.md) | [Create a new transaction](/api-reference/endpoints/transactions/v1-transactions-post.md) | [Verification Endpoints](/api-reference/endpoints/verification.md) | [Check verification code](/api-reference/endpoints/verification/v1-services-verify-check-post.md) | [Send verification code](/api-reference/endpoints/verification/v1-services-verify-send-post.md)  
**Reference / SDK Reference:** [@sapiom/axios](/reference/sdk/axios.md) | [@sapiom/fetch](/reference/sdk/fetch.md) | [SDK Reference](/reference/sdk.md) | [@sapiom/langchain-classic](/reference/sdk/langchain-classic.md) | [@sapiom/langchain](/reference/sdk/langchain.md) | [@sapiom/node-http](/reference/sdk/node-http.md)  
**Reference:** [Concepts](/reference/concepts.md)

---

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](/integration/mcp-servers/setup.md) (`@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:**
```bash
    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`):

    ```json
    {
      "mcpServers": {
        "sapiom": {
          "transport": "http",
          "url": "https://api.sapiom.ai/v1/mcp"
        }
      }
    }
    ```
  
**Cursor / Windsurf:**
Add to your MCP configuration:

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

> 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](https://app.sapiom.ai/settings).

---

## What's available

The remote MCP exposes **130 tools** — one family per capability. Every capability in the [catalog](/capabilities.md) is reachable here as an `sapiom_*` tool:

| Capability | Example tools |
|------------|---------------|
| [Search the Web](/capabilities/search.md) | `sapiom_search`, `sapiom_deep_search` |
| [Web Scraping](/capabilities/scraping.md) | `sapiom_scrape`, `sapiom_crawl`, `sapiom_map`, `sapiom_extract` |
| [AI Model Access](/capabilities/ai-models.md) | `sapiom_chat`, `sapiom_list_models` |
| [Generate Images](/capabilities/images.md) | `sapiom_generate_image` |
| [Audio Services](/capabilities/audio.md) | `sapiom_text_to_speech`, `sapiom_sound_effects`, `sapiom_list_voices` |
| [Browser Automation](/capabilities/browser.md) | `sapiom_fetch`, `sapiom_screenshot`, `sapiom_browser_session_create` |
| [Compute](/capabilities/compute.md) | `sapiom_run`, `sapiom_sandbox_create`, `sapiom_job_deploy` |
| [Data](/capabilities/data.md) | `sapiom_redis_*`, `sapiom_vector_*`, `sapiom_searchindex_*`, `sapiom_database_*` |
| [Messaging](/capabilities/messaging.md) | `sapiom_message_publish`, `sapiom_schedule_create` |
| [File Storage](/capabilities/file-storage.md) | `sapiom_file_upload`, `sapiom_file_download` |
| [Repositories](/capabilities/repositories.md) | `sapiom_git_create_repo`, `sapiom_git_list_repos` |
| [Email & Enrichment](/capabilities/email-enrichment.md) | `sapiom_email_find`, `sapiom_domain_search`, `sapiom_company_enrichment` |
| [Domains & DNS](/capabilities/domains.md) | `sapiom_domains_search`, `sapiom_domains_buy`, `sapiom_dns_create_record` |
| [Verify Users](/capabilities/verify.md) | `sapiom_verify_send`, `sapiom_verify_check` |
| [GitHub Export](/capabilities/github-export.md) | `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.

> **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](https://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](/capabilities.md) - Every capability, with a Direct (remote MCP) / SDK / Workflow tab and full pricing.
  - [Authoring MCP](/integration/mcp-servers/setup.md) - Build multi-step, deployable workflows with @sapiom/mcp instead.