# Soracom Knowledge

Connects AI coding assistants to Soracom manuals, API endpoints, and IoT guides over HTTP. It gives models direct access to official references while building IoT projects.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 4
- Author: soracom
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/soracom/mcp/tree/HEAD/servers/knowledge
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/mcp/soracom-knowledge

## What it does

Soracom hosts this read-only MCP endpoint at `https://knowledge-mcp.soracom.com`. It provides three query tools: `search_soracom_docs` browses user procedures and IoT recipes, `search_api_docs` checks endpoint paths and SAM permissions, while `get_document` extracts full Markdown files by URL. Default searches rely on a hybrid mode combining literal keywords with semantic scoring.

The server does not authenticate callers and cannot alter your cloud resources. Still, every search phrase goes to the external endpoint and through OpenAI embeddings. Never paste account credentials or sensitive tokens into your search prompts.

## Requirements
- Remote server: `https://knowledge-mcp.soracom.com`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add knowledge --url https://knowledge-mcp.soracom.com
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "knowledge": {
            "url": "https://knowledge-mcp.soracom.com"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "knowledge": {
            "type": "http",
            "url": "https://knowledge-mcp.soracom.com"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http knowledge https://knowledge-mcp.soracom.com
```

## When to use it
- Look up Soracom API paths and CLI syntax directly inside the editor
- Retrieve step-by-step IoT setup recipes and console instructions
- Inspect SAM permission definitions for Soracom services
- Pull complete documentation articles in Markdown format

## Example prompts
- Search Soracom documentation for SIM card management endpoints using GET.
- Find the IoT recipe for routing microcontroller telemetry through Soracom Beam.
- Fetch the complete Markdown page for Soracom Flux SAM permissions.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44908
- [Sui Knowledge Base (kapa.ai)](https://affpapa.org/en/nevibecode/mcp/sui-knowledge-base-kapaai.md) — MCP server · ★ 7785
- [Claude Code Ultimate Guide](https://affpapa.org/en/nevibecode/mcp/claude-code-ultimate-guide.md) — MCP server · ★ 6258
- [Zotero MCP](https://affpapa.org/en/nevibecode/mcp/zotero-mcp.md) — MCP server · ★ 5585
- [RevoGrid DataGrid MCP Pro](https://affpapa.org/en/nevibecode/mcp/revogrid-datagrid-mcp-pro.md) — MCP server · ★ 3451
- [Claude Code Explorer MCP](https://affpapa.org/en/nevibecode/mcp/codeaashu-claude-code-explorer-mcp.md) — MCP server · ★ 3412

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
