@hederaintel/platform

HederaIntel

The intelligence layer for AI agents on Hedera.

24 tools. 8 modules. Pay per call in HBAR. No registration.

HederaIntel is a production Model Context Protocol server. It gives AI agents structured, metered access to the full Hedera ecosystem — HCS topics, tokens, DeFi, identity, smart contracts, NFTs, governance, and compliance.

Built for agents that need to reason about Hedera, not just interact with it.

Connect

https://hedera-mcp-platform-production.up.railway.app/mcp

{
  "mcpServers": {
    "hederaintel": {
      "url": "https://hedera-mcp-platform-production.up.railway.app/mcp"
    }
  }
}

How It Works

HederaIntel uses agent-native HBAR payments. No accounts, no OAuth, no email.

1. get_terms        -> read the Terms of Service         (free)
2. confirm_terms    -> record consent                    (free)
3. account_info     -> get platform wallet + pricing     (free)
4. send HBAR        -> your account ID becomes your key  (auto-provisioned)
5. call any tool    -> pass your Hedera account ID as api_key

Platform wallet: 0.0.10298356 (mainnet)

Credits are persistent. Unused balance carries over indefinitely.

Enterprise Safety — HITL Enforcement

All safety controls run server-side. They cannot be bypassed by modifying the npm package.

HITL is enforced on operation type, not balance size. HederaIntel is a read and intelligence platform — the risk surface is irreversible on-chain writes and runaway agent loops.

Trigger	Tier	Behaviour
Any tool call	Consent gate	confirm_terms required
hcs_write_record	Notify	Executes immediately — webhook notification sent to operator
Same tool >20 calls in 60s	Loop guard	Blocked — agent must wait 60s
All other tools	Auto	Executes immediately

Full architecture: SECURITY.md — written for AI agents to read.

Terms of Service: get_terms tool or /public/terms.json

Tools

Free — Onboarding and Legal

Tool	Description
get_terms	Machine-readable Terms of Service. Call before anything else.
confirm_terms	Record consent. Required before any paid tool.
account_info	Platform wallet address, full pricing table, your balance.

Module 1 — HCS Topic Intelligence

Tool	Cost	Description
hcs_monitor	0.05 HBAR	Topic status, message count, recent activity
hcs_query	0.05 HBAR	Natural language Q&A over topic messages, AI-ranked
hcs_understand	0.50 HBAR	Anomaly detection, trend analysis, entity extraction

Module 2 — Compliance and Audit Trail

Tool	Cost	Description
hcs_write_record	2.00 HBAR	Write tamper-evident record to HCS
hcs_verify_record	0.50 HBAR	Verify a record has not been altered
hcs_audit_trail	1.00 HBAR	Full chronological audit history for an entity

Module 3 — Governance Intelligence

Tool	Cost	Description
governance_monitor	0.10 HBAR	Active proposals, deadlines, current vote tallies
governance_analyze	0.50 HBAR	Voter sentiment, participation rate, outcome prediction

Module 4 — Token and DeFi Intelligence

Tool	Cost	Description
token_price	0.05 HBAR	Spot price, 1h/24h/7d change, liquidity — via SaucerSwap
token_monitor	0.10 HBAR	Recent transfers, whale movements, unusual patterns
defi_yields	0.20 HBAR	Live yield opportunities: pools, staking, lending
token_analyze	0.30 HBAR	Holder distribution, velocity, concentration, risk score

Module 5 — Identity Resolution

Tool	Cost	Description
identity_resolve	0.10 HBAR	Account profile: age, holdings, transaction history
identity_verify_kyc	0.20 HBAR	KYC grant status and verification history for a token
identity_check_sanctions	0.50 HBAR	On-chain risk screening, counterparty patterns

Module 6 — Smart Contract Intelligence

Tool	Cost	Description
contract_read	0.10 HBAR	Metadata, bytecode size, recent callers, gas stats
contract_call	0.50 HBAR	Read-only function call — no gas, no transaction
contract_analyze	1.00 HBAR	Activity patterns, caller distribution, risk classification

Accepts both Hedera native IDs (0.0.123456) and EVM addresses (0x...).

Module 7 — NFT and Holder Intelligence

Tool	Cost	Description
nft_collection_info	0.10 HBAR	Supply, royalties, treasury, token properties
nft_token_metadata	0.10 HBAR	Serial-level data: IPFS metadata, current owner
token_holders	0.20 HBAR	Top holders, concentration metrics, whale analysis
nft_collection_analyze	0.30 HBAR	Whale concentration, transfer velocity, rarity signals

Architecture

AI Agent
    | MCP (stdio or Streamable HTTP)
    v
@hederaintel/platform (npm, ~15 KB)
    | tool schemas + HTTPS proxy — zero business logic
    v HTTPS
HederaIntel Remote Brain (Railway, proprietary)
    |-- consent gate
    |-- HITL enforcement
    |-- HBAR payment processing
    |-- SaucerSwap API (live token prices)
    |-- Hedera mirror node
    |-- SQLite (balances, consent log, HITL events)
    v
Hedera Mainnet

The npm package contains no business logic — only tool schemas and a proxy. Intelligence, payments, and safety enforcement live in the private remote server and are never published to npm.

What's New in v2.8.0

• Leaner tool set — removed governance_vote and the entire bridge module; 24 focused tools across 8 modules
• contract_call return type decoding — pass return_types for precise ABI decoding of tuples, arrays, and multi-value returns
• EVM address support — all identity and contract tools accept 0x... addresses directly
• Live HBAR/USD pricing — account_info shows real-time USD cost for every tool
• @hederaintel/platform — npm namespace (migrated from hedera-mcp-platform)

Known Limitations

• Mirror node balance endpoint occasionally returns empty for high-holder tokens. Metadata unaffected.

Links

npm	https://www.npmjs.com/package/@hederaintel/platform
MCP Registry	https://registry.modelcontextprotocol.io — search hederaintel
Live endpoint	https://hedera-mcp-platform-production.up.railway.app/mcp
Terms	https://hedera-mcp-platform-production.up.railway.app/terms
Health	https://hedera-mcp-platform-production.up.railway.app/health

License

npm package (src/index.js, src/tools.js, src/proxy.js) — provided for integration use.

Remote server (src/modules/, src/server.js, src/payments.js, and all backend logic) — Proprietary. See LICENSE.md.

Enterprise licensing and SLA inquiries: open an issue titled [Enterprise].