Skip to main content

Hgraph AI Data Agent

Explore blockchain data using natural language—no coding or API keys required.

Powered by the Hgraph MCP Server.

What is the AI Data Agent?​

The Hgraph AI Data Agent is a conversational interface to live blockchain data across every network Hgraph serves — Hedera and 20+ EVM networks. Ask questions in plain English (or other languages) and get instant answers about network activity, tokens, accounts, smart contracts, NFTs, and more.

  • Natural language — No query syntax to learn
  • Real-time data — Connected to Hgraph's live node and indexer infrastructure
  • Conversational — Ask follow-up questions to dig deeper
  • Accessible — Built for everyone, not just developers

Which chains are supported?​

The agent discovers its chain catalog live from the Hgraph MCP Server, so newly added chains appear automatically. It infers the chain from context—Hedera entity IDs like 0.0.800 route to Hedera, while 0x addresses route to the EVM chain you name or imply.

tip

Ask the agent "Which chains can you query?" for the current list.

Why We Built It​

We believe everyone should be able to explore blockchain data—not just developers with API expertise.

The AI Data Agent removes the barrier between your questions and on-chain insights. Whether you're tracking token activity, analyzing account portfolios, or exploring network trends, you can now get answers in seconds.

Same powerful data. Accessible to everyone.

How to Access​

Start Exploring at hgraph.ai →​

Sign in with any of these options:

  • Email — Magic link and one-time code sent to your inbox
  • Google — Sign in with your Google account
  • GitHub — Sign in with your GitHub account

That's all you need. No API key setup is required—your organization's credential is resolved securely on our servers and never reaches your browser. If you're brand new to Hgraph, a workspace is created for you automatically when you send your first message.

Fast and Deep Responses​

Every message is answered in one of two response depths, selectable next to the send button:

  • Fast (default) — Answers in seconds. Best for lookups and everyday questions.
  • Deep — Chains many queries together for a single answer. Best for analysis, comparisons, and working through larger datasets.

Deep responses are available on Team and Premium plans.

Plans & Limits​

LimitFreePaid plans
Conversations per day1050
Messages per conversation2Unlimited
Deep responses—Team & Premium: 25 per member per day

Each organization also has a monthly usage ceiling that keeps costs predictable; the agent lets you know if your organization reaches it. Limits may change as we refine the product—see plans and pricing.

Getting Started​

  1. Visit hgraph.ai
  2. Sign in with your preferred method
  3. Ask a question about on-chain data

That's it—start exploring immediately.

Keyboard shortcuts​

  • ⌘K (Ctrl+K) — Start a new chat
  • ⌘B (Ctrl+B) — Toggle the sidebar

What You Can Ask​

The AI Data Agent can answer questions about transactions, token holders, accounts, smart contracts, NFT collections, and more, on Hedera and the EVM networks Hgraph serves.

Try these prompts:

  • "Which networks can you query?"
  • "What happened on Hedera yesterday?"
  • "What's the latest block on Base?"
  • "Tell me about this account: 0.0.800"
  • "Top holders for this token: 0.0.456858"
  • "10 recently created smart contracts"
  • "HBAR price insights"
  • "Which chains can you query?"

For more prompt ideas, see MCP Server Examples →

Attaching a CSV​

Have a list of accounts or tokens to analyze? Attach a CSV of addresses using the paperclip button, or drag and drop the file onto the chat.

  • Fast responses read the first 250 rows of your file
  • Deep responses process the whole file, up to 5,000 rows or 512 KB

If a Fast response caps your file, the agent tells you how many rows it used—switch to Deep to cover the rest.

Chats, History, and Organizations​

Your conversations are saved to your organization's workspace, so you can revisit them from any device:

  • History — The sidebar lists every conversation in the selected organization
  • Search — Find past chats by title from the sidebar search
  • Rename & delete — Manage conversations from each chat's menu in the sidebar
  • Organizations — If you belong to more than one organization, switch between them from the account menu; each keeps its own history

Tips for Better Results​

Do​

  • Be specific — Include entity IDs (e.g., "account 0.0.800") and time ranges (e.g., "in the last 7 days")
  • Name the chain when it isn't obvious from the entity ID
  • Ask follow-ups — The agent remembers context within a conversation
  • Use Deep for analysis — Multi-step questions and larger CSVs get better answers in Deep
  • Explore freely — Try different phrasings if you don't get the expected result

Avoid​

  • Vague requests — "Show me some data" is harder to answer than "Show me the top 10 tokens by holder count"
  • Write operations — The agent can only read blockchain data, not send transactions

Understanding Results​

The agent doesn't just answer in prose—results render as rich, interactive blocks:

  • Charts — Time series and comparisons render as charts you can switch to a table view, or download as PNG or CSV
  • Tables — Sortable columns, with CSV download and copy
  • Entity cards — Accounts, tokens, and contracts appear as cards with key stats and a link to a block explorer
  • Suggested follow-ups — One tap to keep digging

Viewing the Underlying Queries​

Each response shows the queries it ran. Expand one to see the exact query, then:

  • Copy query — Grab it for your own use
  • Open in playground — Run and modify it in the interactive playground
  • Docs — Jump to the reference documentation for that query language

This transparency helps you understand how answers are generated and verify the data sources.

tip

If you're learning to work with on-chain data, expanding the queries is a great way to see real examples in action.

Sharing a Conversation​

Any conversation can be published as a public, read-only share page:

  1. Open the chat and select Share
  2. Choose what the page includes:
    • Include the queries — Show the queries behind each answer
    • Keep updating — New messages appear on the share page; leave it off to freeze the page at the moment you publish
  3. Create share link and copy the URL

Anyone with the link can read the conversation without signing in. Visitors can also select Continue this chat to copy the conversation into their own account and ask their own follow-ups.

You can unpublish at any time—the link stops working immediately. Publishing again later reuses the same link.

For Developers​

Want more control over how you access the data?

The Hgraph MCP Server powers the AI Data Agent and is available for you to connect directly to your own AI workflows:

  • Use with Claude Desktop, ChatGPT, or other MCP-compatible clients
  • Integrate into your development environment
  • Build custom applications with natural language data access

Both the AI Data Agent and MCP Server are powered by the same Hgraph infrastructure.

Learn more about the MCP Server →

FAQ​

Do I need coding experience?​

No. The AI Data Agent is designed for anyone to use, regardless of technical background.

Do I need an API key?​

No. Signing in is all that's required—your organization's credential is managed server-side and never exposed to your browser. Developers who want direct API access can still create keys at app.hgraph.com.

Is my data private?​

The agent queries only public blockchain data. Your conversations are saved privately to your organization's workspace so you can revisit them; delete a chat to remove it. Nothing is visible outside your organization unless you create a share link, and you can unpublish a share link at any time.

Can the agent send transactions?​

No. The AI Data Agent is read-only. It can query blockchain data but cannot sign or submit transactions.

What's the difference between the Agent and MCP Server?​

  • AI Data Agent — Hosted web app, no setup required, instant access
  • MCP Server — Self-configured connection to your own AI tools, more flexibility

Both provide access to the same Hgraph data.

How current is the data?​

Data comes from Hgraph's real-time node and indexer infrastructure. Most data is available within seconds of network consensus.

What if I need API access or a custom solution?​

For direct API access, custom integrations, or enterprise needs:

Contact our team →

Feedback & Support​

We're actively improving the AI Data Agent and want to hear from you: