Soracom Knowledge — Claude Code MCP server: setup and tools
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.
claude mcp add --transport http knowledge https://knowledge-mcp.soracom.comWhat Soracom Knowledge 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.
What it helps with
- 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 for the agent
- 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.
How to install Soracom Knowledge
Platform CLI: remote server
claude mcp add --transport http knowledge https://knowledge-mcp.soracom.comPlatform CLI: remote server
codex mcp add knowledge --url https://knowledge-mcp.soracom.comConfig file
{
"mcpServers": {
"knowledge": {
"url": "https://knowledge-mcp.soracom.com"
}
}
}Config file
{
"servers": {
"knowledge": {
"type": "http",
"url": "https://knowledge-mcp.soracom.com"
}
}
}Platform CLI: remote server
gemini mcp add -t http knowledge https://knowledge-mcp.soracom.comStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Soracom Knowledge
How do I install Soracom Knowledge in Claude Code?
Run claude mcp add --transport http knowledge https://knowledge-mcp.soracom.com in your terminal.
What does Soracom Knowledge do?
It lets assistants search official Soracom guides, API references, and IoT blueprints over a public HTTP endpoint.
Does the server require an account or credentials?
No login is needed because the hosted endpoint is public and restricted to read-only documentation searches.
