Soracom Knowledge

com.soracomPublished by soracom.comOfficial publisherv1.1.5Updated Oct 24, 2026

Search SORACOM documentation: service guides, FAQ, API references, IoT recipes, etc.

VerifiedStreamable HTTPWeb executableKnowledge & Memory Developer Tools

Server details

Identifier: com.soracom/knowledge
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to soracom.com, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/com.soracom%2Fknowledge.svg)](https://sourceweft.com/mcp/com.soracom%2Fknowledge?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A hosted, read-only MCP endpoint that lets an assistant search SORACOM documentation and API references and fetch full pages.

What you can do: Search SORACOM service guides, User Console how-tos, pricing, changelogs and IoT recipes, in English or Japanese, with keyword, semantic or hybrid mode and optional site filtering. Search API references, CLI commands and SAM permissions, optionally narrowed by service tag, HTTP method or path fragment. Fetch the full Markdown of a page or API schema link returned by a search.
When to use it: Useful when an assistant answers questions about SORACOM services, the User Console, pricing, IoT recipes, SORACOM API endpoints, soracom-cli commands or SAM permissions, and should ground answers in official documentation rather than training data.
Requirements: A remote MCP client that supports Streamable HTTP, pointed at the public SORACOM endpoint. No account, API key or header is needed. Network access to the endpoint is required.

Before you install

No per-user authentication: every query is sent to the endpoint, and in hybrid or semantic mode also to OpenAI for embeddings, so keep confidential information, account identifiers, credentials and personal data out of queries. Read-only and does not modify SORACOM resources. Results may be loosely related and the index lags documentation changes; verify important details against source pages. Free, best-effort, no SLA, and heavy use may be throttled.

Installation

In SourceWeft

Open Soracom Knowledge in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.soracom%2Fknowledge/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Soracom Knowledge MCP Server

The Soracom Knowledge MCP Server is an MCP (Model Context Protocol) server that lets AI agents search Soracom documentation and Soracom API references directly from your development environment. When connected to an MCP client such as Claude Code, OpenAI Codex, or Claude Desktop, the agent can look up service guides, Soracom User Console procedures, pricing, IoT recipes, Soracom API references, CLI commands, and SAM permissions on demand, and ground its answers in the official documentation instead of relying only on its training data.

The server is hosted by Soracom as a shared, read-only endpoint. It does not modify any of your Soracom resources—the agent only searches and reads documentation.

Available Tools

The server exposes three read-only tools to the connected agent. None of them modify your account or its resources.

The server's default hybrid search mode combines keyword search with semantic search (using OpenAI embeddings) and merges the results using Reciprocal Rank Fusion (RRF).

search_soracom_docs

Searches Soracom service guides, Soracom User Console procedures, service overviews and pricing, and IoT recipes.

Parameter	Description
`query`	A natural-language search query (required).
`document_names`	Restricts the search to specific sites (e.g., `["docs.soracom.io", "users.soracom.io"]`). The available sites are listed in the tool schema. Omit it to search all sources.
`search_mode`	`hybrid` (default; combines keyword and semantic search), `keyword` (keyword search only), or `semantic` (semantic similarity only).
`language`	`English` or `Japanese`. Auto-detected from the query when omitted.
`max_results`	Number of results to return. Default 16, maximum 32.

search_api_docs

Searches Soracom API references, CLI commands, and SAM permissions.

Parameter	Description
`query`	A natural-language question or an API endpoint name. Optional when at least one of `tag`, `method`, or `path` is supplied.
`tag`	Restricts results to a service tag (e.g., `Sim`, `Subscriber`, `Flux`). Case-insensitive exact match.
`method`	Restricts results to an HTTP method (e.g., `GET`, `POST`). Case-insensitive exact match.
`path`	Restricts results to an API path fragment (e.g., `/sims`). Case-insensitive substring match.
`search_mode`	`hybrid` (default; combines keyword and semantic search), `keyword` (keyword search only), or `semantic` (semantic similarity only).
`language`	`English` or `Japanese`. Auto-detected from `query` when `query` is provided. If you omit `query`, specify `language` explicitly.
`max_results`	Number of results to return. Default 16, maximum 32.

get_document

Fetches the full Markdown of a page returned by search_soracom_docs or search_api_docs.

Parameter	Description
`url`	The URL of the page to fetch (required). Pass the `url` value from a search result verbatim. A search result may return a URL that is not directly viewable in a browser (such as a fragment of a split API reference), but this tool can still fetch its content.

Connecting the Server

The server is reachable at a stable public HTTPS endpoint and uses the MCP Streamable HTTP transport:

[!WARNING] The server has no per-user authentication. It only searches and returns public Soracom documentation, but any query you enter is sent to the endpoint. With the hybrid or semantic search mode, your query is also sent to OpenAI to generate embeddings. Do not include confidential information, account identifiers, credentials, or personal data in your queries.

For Soracom's terms and privacy practices, see the Terms and Conditions and Privacy Policy. Soracom does not record or retain the content of your queries in its server logs. Soracom also does not share OpenAI API inputs or outputs with OpenAI for model improvement, evaluation, fine-tuning, or training. For details, see OpenAI's Business data privacy, security, and compliance.

Use of this server is subject to our Site Policy (available in Japanese), which includes disclaimers, copyright terms, and provides that use is governed by the laws of Japan, with the Tokyo District Court as the exclusive court of first instance. The Japanese text prevails.

Claude Code

Claude Code supports remote HTTP MCP servers natively. Add the server with the claude mcp add command:

Verify that the server is connected:

The soracom-knowledge server and its three tools are now available in your Claude Code sessions. To remove it later, run claude mcp remove soracom-knowledge.

OpenAI Codex

The Codex CLI supports remote MCP servers over HTTP. Add the server with:

List configured servers to confirm:

Notes and Limitations

This server is provided free of charge on a best-effort basis and without an SLA. Its specifications may change without notice as the service is improved.
Access may be temporarily restricted if an excessive number of requests are detected.
A result set may include pages that are only loosely related to your query. The agent is expected to filter these; treat individual hits as candidates rather than authoritative matches.
The information returned by this server is provided "AS-IS", and answers generated by an AI agent are not guaranteed to be accurate. Verify important details against the linked source pages.
The search index is updated periodically, so it may take some time for changes to the public documentation to be reflected in search results.

This page mirrors the official documentation: English | Japanese. Registry: com.soracom/knowledge on the Official MCP Registry.

Source: servers/knowledge/README.md at commit 081b555

Tools

get_document

Get Full SORACOM Documentation Page

Fetch full markdown for a SORACOM documentation page. Also resolves API schema links. Exact URLs are attempted first.

Parametersurlrequired

search_api_docs

Search SORACOM API Documentation

Search SORACOM API documentation, CLI references, and SAM permissions. Use for exact API endpoints, soracom-cli commands, or SAM permission strings. Use search_soracom_docs for service guides, console how-tos, pricing, or IoT recipes. Use get_document on `#/schema/<Name>` links in results to read full API schema fields.

Parameterstagpathquerymethodlanguagemax_resultssearch_mode

search_soracom_docs

Search SORACOM Documentation

Search SORACOM service documentation, guides, and console how-to articles (user site, service overviews and pricing, IoT recipes). Covers SORACOM services, subscription plans, User Console operations, changelogs, blogs, devices, IoT Store, partners, contract terms, and use cases. Use search_api_docs for API references, CLI commands, or SAM permissions.

Parametersqueryrequiredmarketlanguagemax_resultssearch_modedocument_names

Version history

v1.1.5LatestOct 8, 2026
v1.1.4Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts