How to integrate HydraDB MCP with Hermes

Connect Hermes to HydraDB MCP. Query hydradb for recent customer complaint trends, ingest product documentation into hydradb context, and more using natural language, with authentication handled for you.

HydraDB logoHydraDB
Api Key

HydraDB is a hosted context layer for ingesting, connecting, and querying data for AI applications. It helps teams give AI systems organized, searchable context from their data.

43 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 HydraDB 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.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate HydraDB with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ 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 HydraDB 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 HydraDB

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

4. Done. You're all set with a new HydraDB 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 HydraDB or request any HydraDB-related task. It will prompt you to authenticate and authorize access.

5. Done!

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

The HydraDB MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your HydraDB account. It provides structured and secure access to your databases, collections, connected data sources, contexts, and indexing workflows, so your agent can ingest data, search knowledge, manage connected providers, explore relationships, and monitor processing on your behalf.

  • Knowledge ingestion and search: Have your agent add documents, application knowledge, memories, or graph data to HydraDB, then query the resulting context with filters for collections, metadata, sources, access controls, and retrieval settings.
  • Database and collection management: Let the agent create, inspect, list, and remove HydraDB databases and collections, check database readiness, review usage statistics, and manage metadata schema fields.
  • Connected data source management: Direct your agent to review supported connector providers, create and configure connectors, discover available resources, select resources for syncing, pause or resume connectors, trigger syncs, and check connector health.
  • Context exploration and processing: Instruct your agent to inspect stored context, check ingestion status, list knowledge or memory contexts, retrieve extracted relations, and traverse related context subgraphs.
  • Indexing webhook operations: Have your agent register and test indexing webhooks, manage signing secrets, review delivery attempts, retry failed deliveries, and remove webhook registrations.

Way Forward

With HydraDB 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 HydraDB action and event your agent gets out of the box.

Add Connector Resource

Add one discovered provider resource to an existing connector with optional routing, filters, metadata, instructions, and access control.

Add Metadata Schema Fields

Add new fields to a database metadata schema; existing fields cannot be deleted, renamed, retyped, or reconfigured.

Configure Connector Resources

Activate selected discovered resources on a connector and start their sync; unlisted existing resources remain unchanged.

Create Connector

Create a HydraDB connector and store the provider authorization required to sync one external account.

Create Database

Provision a HydraDB database asynchronously.

Delete Collection

Permanently delete one HydraDB collection and all of its data while leaving the database intact.

Delete Connector

Permanently delete a HydraDB connector, all resource mappings, and its stored provider authorization.

Delete Connector Resource

Permanently remove one resource mapping from a HydraDB connector.

Delete Context

Permanently delete specific HydraDB knowledge or memory contexts.

Delete Database

Permanently delete a HydraDB database and all associated data.

Delete Indexing Webhook

Unregister the account's indexing webhook and stop all future event deliveries.

Disable Webhook Signing

Remove the indexing webhook signing secret.

Discover Connector Resources

List resources available through an existing connector's stored provider credentials.

Generate or Set Webhook Signing Secret

Generate or set and replace the indexing webhook signing secret.

Get Connector

Get one connector's configuration and lifecycle state by connector ID.

Get Connector Status

Check a connector's overall health, sync state, errors, and per-resource health in one call.

Get Context Relations

Return extracted entity relations for one context or an entire collection, one page at a time.

Get Context Status

Check processing status for one or more ingested or connector-synced context IDs.

Get Context Subgraph

Traverse context-level relations from one context and return reachable contexts and graph evidence up to bounded depth and size.

Get Database Stats

Get knowledge and memory collection row counts for one database.

Get Database Status

Check whether one database's scheduler, graph, and vector infrastructure is ready for ingestion.

Get Indexing Webhook

Get the account's indexing webhook URL, subscribed event types, registration state, and whether signing is configured.

Get Metadata Schema

Get the declared metadata fields and types for one database.

Get Webhook Delivery

Get one indexing webhook delivery attempt by delivery ID for failure diagnosis.

Ingest Context

Ingest documents, app knowledge, memories, or an explicit graph into a HydraDB database and return context IDs for asynchronous status checks.

Inspect Context

Fetch one context's stored content, enrichment, and/or a time-limited download URL.

List Collections

List the collections in one HydraDB database.

List Connector Providers

List supported connector providers, or describe one provider's resource types, credential schema, and setup requirements.

List Connector Resources

List the resources currently configured on a connector, including routing, filters, access controls, and per-resource health metadata.

List Connectors

List the connected data providers in the account, optionally filtered by provider, with optional health rollups.

List Contexts

List knowledge or memory contexts in a database or collection, one bounded page at a time.

List Databases

List HydraDB databases and preserve per-database provisioning or failure diagnostics.

List Webhook Deliveries

List recent indexing webhook delivery attempts, optionally filtered by status, one page at a time.

Query Context

Search a HydraDB database for ranked chunks and graph context, with optional collection, metadata, source, ACL, and retrieval controls.

Register Indexing Webhook

Register or replace the organization's HTTPS endpoint and event subscriptions for HydraDB indexing events.

Retry Webhook Delivery

Queue one failed indexing webhook delivery for another attempt.

Set Connector Paused State

Pause scheduled syncs or resume a paused HydraDB connector.

Submit Query Feedback

Record a rating, comment, or known ground truth for a prior HydraDB query.

Test Indexing Webhook

Send one test event to the currently registered indexing webhook endpoint.

Trigger Connector Sync

Start a connector sync now, causing external provider reads and HydraDB ingestion.

Update Connector

Update an existing HydraDB connector's sync cadence, default ingestion instructions, or provider credentials.

Update Connector Resource

Replace a HydraDB connector resource's access rules or change its ingestion instructions for subsequent syncs.

Update Context Metadata

Merge metadata into one HydraDB context or replace its access-control list without re-ingesting content.

FAQ

Frequently asked questions

Start with HydraDB.It takes 30 seconds.

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

Start building