# Bitquery: Hermes Agent plugin

> On-chain data in Hermes: token prices and candles, DEX trades, trader PnL, transfer tracing on 19 chains, address labels and risk reports, Hyperliquid and Polymarket data, through Bitquery's hosted MCP server…

Canonical: https://hermeswatcher.com/plugins/bitquery  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/bitquery  
Last updated in catalog: 2026-11-17

On-chain data in Hermes: token prices and candles, DEX trades, trader PnL, transfer tracing on 19 chains, address labels and risk reports, Hyperliquid and Polymarket data, through Bitquery's hosted MCP server (Streamable HTTP, OAuth 2.1 with dynamic client registration and PKCE), with eight workflow skills bundled. Portable Agent Plugins v1 package (plugin.json + mcp.json + skills/).

## Good to know before installing

Hosted-only connector with no local code: every tool call goes to Bitquery's MCP server at mcp.bitquery.io, signed in as the user through Bitquery's sign-in, and a first sign-in creates a Bitquery account on a free 7-day trial. The addresses, tokens and questions in a call are sent to Bitquery, each call uses credits from the user's Bitquery plan, and results are pulled into the session context, so they reach the user's model provider. Every tool is read-only (readOnlyHint on all of them): none signs or sends a transaction, places an order or changes the user's account. The tool list comes from Bitquery's server at run time, so the pinned commit doesn't cover it. Hermes stores and refreshes the OAuth tokens. OAuth must be enabled with `hermes mcp add bitquery --url https://mcp.bitquery.io/mcp --auth oauth --connect-timeout 300`; the bundled mcp.json alone yields 401.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install bitquery
```

2. Said no? Turn it on later:

```bash
hermes plugins enable bitquery
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Cost, speed & monitoring, Work & business
- Maintained by: bitquery (Community)
- Needs: No API keys declared
- Requires Hermes: `>=0.22.0`
- Version: 1.0.0
- In the catalog since: 2026-11-17

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/bitquery)
- [Source code](https://github.com/bitquery/hermes-plugin/blob/a37f548a7e7f3c03a99a89655dfaf9d4c07a60db/README.md)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
