# Soracom Knowledge

> Soracom Knowledge is a free MCP server for developer tools. Search Soracom docs, API references and CLI commands from your AI coding agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://docs.soracom.io/en/developers/knowledge-mcp-server
- **Repository:** https://github.com/soracom/mcp/tree/HEAD/servers/knowledge
- **MCP Registry name:** com.soracom/knowledge
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Soracom hosts this as a shared, read-only endpoint, so an agent can ground answers about its IoT connectivity platform in the official documentation rather than training data. It covers service guides, User Console procedures, pricing pages, IoT recipes, API references, CLI commands and SAM permissions, in English or Japanese with the language auto-detected from the query.

Search defaults to a hybrid mode that merges keyword and semantic results with Reciprocal Rank Fusion; keyword-only and semantic-only modes are available. Results default to 16 and can go up to 32. A separate API-docs search can be filtered by service tag such as Sim, Subscriber or Flux, by HTTP method, or by path fragment.

There is no per-user authentication and the server never touches your Soracom resources. Because queries go to the endpoint, and to OpenAI for embeddings in hybrid and semantic modes, the docs warn against sending credentials, account identifiers or personal data. Soracom says it does not retain query content in its logs.

## Features

- **Docs search:** Searches service guides, console procedures, pricing and IoT recipes.
- **API reference search:** Filters by tag, HTTP method or path, covering API, CLI and SAM permissions.
- **Full page fetch:** Retrieves the full Markdown of any page a search returned.
- **Hybrid search modes:** Choose hybrid, keyword or semantic search per call.
- **Bilingual:** Works in English and Japanese.

## Good for

- Ask an agent how to configure a SIM group in the console
- Look up the right API endpoint and its SAM permission
- Find the CLI command for a Soracom task
- Check Soracom pricing details while drafting a design

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://knowledge-mcp.soracom.com
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "knowledge": {
      "url": "https://knowledge-mcp.soracom.com"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "knowledge": {
      "type": "http",
      "url": "https://knowledge-mcp.soracom.com"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "knowledge": {
      "serverUrl": "https://knowledge-mcp.soracom.com"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "knowledge": {
      "type": "http",
      "url": "https://knowledge-mcp.soracom.com"
    }
  }
}
```

## Tools

- `search_soracom_docs`: Searches service guides, User Console procedures, pricing and IoT recipes.
- `search_api_docs`: Searches API references, CLI commands and SAM permissions.
- `get_document`: Fetches the full Markdown of a page returned by a search.

## FAQ

### Can it change my Soracom account?

No. All three tools are read-only and only search or fetch public documentation.

### Is sign-in required?

No. There is no per-user authentication.

### What should I avoid sending?

Credentials, account identifiers and personal data, since queries are sent to the endpoint and to OpenAI for embeddings in hybrid or semantic mode.

### Which clients work?

The docs name Claude Code, OpenAI Codex and Claude Desktop.

### Is Soracom Knowledge free?

Yes. Soracom Knowledge is free to use.

### How do I add Soracom Knowledge to Claude Code?

Run this command in your terminal: claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com

### What are the best alternatives to Soracom Knowledge?

The closest alternatives to Soracom Knowledge are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/soracom-knowledge
