SORACOM Data Reader MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SORACOM_AUTH_KEY | Yes | Your SORACOM SAM user authentication key secret (required) | |
| SORACOM_COVERAGE | No | SORACOM coverage area (optional, default: jp) | jp |
| SORACOM_AUTH_KEY_ID | Yes | Your SORACOM SAM user authentication key ID (required) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_harvest_dataA | 特定SIMのHarvest Dataを取得します Args: imsi: SIMのIMSI from_time: 取得開始時刻（UNIXタイムスタンプ・ミリ秒） to_time: 取得終了時刻（UNIXタイムスタンプ・ミリ秒） sort: ソート順（asc: 古い順, desc: 新しい順） limit: 取得件数（最大1000） last_evaluated_key: ページング用キー Returns: Harvest Dataのリストと次ページのキー |
| get_harvest_data_by_resourceA | リソースタイプとIDでHarvest Dataを取得します Args: resource_type: リソースタイプ（subscriber, device など） resource_id: リソースID from_time: 取得開始時刻（UNIXタイムスタンプ・ミリ秒） to_time: 取得終了時刻（UNIXタイムスタンプ・ミリ秒） sort: ソート順（asc: 古い順, desc: 新しい順） limit: 取得件数（最大1000） last_evaluated_key: ページング用キー Returns: Harvest Dataのリストと次ページのキー |
| list_harvest_filesC | Harvest Filesのファイル・ディレクトリ一覧を取得します Args: scope: スコープ（private または operators/{operator_id}） path: パス（デフォルト: /） limit: 取得件数 last_evaluated_key: ページング用キー Returns: ファイル・ディレクトリ一覧 |
| get_harvest_file_infoB | Harvest Filesのストレージ使用状況を取得します Args: scope: スコープ（private または operators/{operator_id}） Returns: ストレージ使用状況（使用量、ファイル数など） |
| get_harvest_file_download_urlC | Harvest Filesのファイルダウンロード用URLを取得します Args: scope: スコープ（private または operators/{operator_id}） path: ファイルパス Returns: ダウンロード用URL（リダイレクトURL） |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose with no overlap. get_harvest_data retrieves data by SIM IMSI, get_harvest_data_by_resource retrieves data by resource type/ID, get_harvest_file_download_url gets download URLs, get_harvest_file_info gets storage usage, and list_harvest_files lists files/directories. The descriptions make it easy to differentiate between data retrieval methods and file management operations.
All tools follow a consistent verb_noun pattern with 'get_' or 'list_' prefixes followed by descriptive nouns. The naming is perfectly uniform across all five tools, making them predictable and easy to understand at a glance.
Five tools is an ideal number for this server's purpose of reading SORACOM Harvest data and files. Each tool serves a specific, necessary function without redundancy, covering both data retrieval (by SIM and resource) and file management operations in a well-scoped manner.
The toolset provides comprehensive read-only coverage for Harvest data and files, including multiple query methods, file listing, download URLs, and storage info. The only minor gap is the lack of write/update operations, but as a 'Data Reader' server, this aligns with its stated purpose, and agents can work effectively within this read-only scope.