How to integrate QuickNode MCP with Hermes

Connect Hermes to QuickNode MCP. List latest blocks and transactions, get pending transactions for address, and more using natural language, with authentication handled for you.

QuickNode MCP logoQuickNode MCP
Dcr Oauth

QuickNode MCP is a managed platform for live blockchain data and RPC endpoint management. It centralizes security, rate limits, monitoring, and billing for your nodes.

22 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your QuickNode account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate QuickNode MCP with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating QuickNode with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to QuickNode

Ask your agent to connect to QuickNode, or simply request any QuickNode-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new QuickNode connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to QuickNode or request any QuickNode-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the QuickNode MCP server, and what's possible with it?

The QuickNode MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your QuickNode account. It provides structured and secure access so your agent can perform QuickNode operations on your behalf.

Way Forward

With QuickNode connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every QuickNode MCP action and event your agent gets out of the box.

Call-rpc

Call an allowed read-only JSON-RPC method through authenticated Quicknode Tooling Access.

Create-endpoint

Create a new web3 RPC endpoint for a given chain and network under user's Quicknode account.

Create-endpoint-method-rate-limit

Create a new method-specific rate limiter for a Quicknode endpoint

Create-security-rule

Create a security rule for a Quicknode endpoint.

Delete-endpoint

Archive a Quicknode endpoint by its ID.

Delete-endpoint-method-rate-limit

Delete a method-specific rate limit from a Quicknode endpoint.

Delete-security-rule

Delete a security rule from a Quicknode endpoint.

Disable-tooling-access

Disable account-level Quicknode Tooling Access.

Enable-tooling-access

Enable account-level Quicknode Tooling Access.

Get-billing

Get billing data for the user's Quicknode account.

Get-endpoint

Get a specific web3 Quicknode endpoint details by id

Get-endpoint-log-details

Get detailed request and response information for a specific log entry.

Get-endpoint-metrics

Get metrics for a specific Quicknode endpoint.

Get-rpc-usage

Get the usage data for the user's Quicknode RPC account.

List-chains

List all chains and network slugs supported by Quicknode.

List-endpoint-logs

List the request/response logs for a specific Quicknode endpoint

List-endpoint-method-rate-limits

List all method rate limits for a specific Quicknode endpoint

List-endpoints

Get web3 Quicknode endpoints for the user, this is a list of all the endpoints that the user has created across all chains and networks.

List-endpoint-security

List all security options and rules for a Quicknode endpoint.

Update-endpoint-method-rate-limit

Update an existing method-specific rate limit for a Quicknode endpoint

Update-endpoint-rate-limits

Update the general rate limits (RPS, RPM, RPD) for a Quicknode endpoint.

Update-endpoint-security-options

Update security options for a specific Quicknode endpoint

FRAMEWORKS

How to build QuickNode MCP Agent with another framework

FAQ

Frequently asked questions

With a standalone QuickNode MCP server, the agents and LLMs can only access a fixed set of QuickNode tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from QuickNode and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right QuickNode tools.

Yes, absolutely. You can configure which QuickNode scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your QuickNode data and credentials are handled as safely as possible.

Start with QuickNode MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every QuickNode MCP tool your agent needs.Free to start.

Start building