hcs_monitor
Monitor HCS topic status and metadata on Hedera, including message count, creation time, memo, and recent activity. Costs 0.05 HBAR per query.
Instructions
Get current status and metadata of any HCS topic - message count, creation time, memo, and recent activity. Defaults to the HederaIntel platform topic. Costs 0.05 HBAR.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | Yes | Your HederaIntel API key | |
| topic_id | No | Hedera topic ID (e.g. 0.0.8026796). Defaults to the HederaIntel platform topic. |
Implementation Reference
- src/modules/hcs/tools.js:56-70 (handler)The handler logic for hcs_monitor which retrieves topic info and recent messages using getTopicInfo and getTopicMessages.
if (name === "hcs_monitor") { const topicId = args.topic_id || PLATFORM_TOPIC; const info = await getTopicInfo(topicId); const messages = await getTopicMessages(topicId, 5); return { topic_id: topicId, memo: info.memo, created_timestamp: info.created_timestamp, deleted: info.deleted, recent_message_count: messages.length, latest_message: messages[0] || null, network: process.env.HEDERA_NETWORK, timestamp: new Date().toISOString(), }; } - src/modules/hcs/tools.js:9-20 (schema)The definition and input schema for the hcs_monitor tool.
{ name: "hcs_monitor", description: "Get current status and metadata of any HCS topic - message count, creation time, memo, and recent activity. Defaults to the HederaToolbox platform topic. Costs 0.1 HBAR.", inputSchema: { type: "object", properties: { topic_id: { type: "string", description: "Hedera topic ID (e.g. 0.0.8026796). Defaults to the HederaIntel platform topic." }, api_key: { type: "string", description: "Your HederaIntel API key" }, }, required: ["api_key"], }, },