HydraDB MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with HydraDB MCP or direct API to ingest data, connect related context, query knowledge, and retrieve AI-ready answers through natural language.

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

Try HydraDB now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
HydraDB
Try asking
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.

SETUP GUIDE

Connect HydraDB MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["hydradb"],
  mcp: true,
});
Create a session scoped to HydraDB and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Query my HydraDB context for the three most common product complaints in the latest customer support dataset.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a HydraDB request
SETUP GUIDE

Connect HydraDB API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["hydradb"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to HydraDB
3

Run HydraDB tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Query my HydraDB context for the three most common product complaints in the latest customer support dataset." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the HydraDB tool calls through the session, and print the final answer

Why Use Composio?

AI Native HydraDB Integration

  • Supports both HydraDB MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable context ingestion and querying
  • Rich coverage for connecting, searching, and retrieving HydraDB data

Secure API Key Auth

  • Connect HydraDB with your own API key credentials
  • Central place to manage, scope, and revoke HydraDB access
  • Secure credential storage keeps API keys out of prompts and application code

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access HydraDB
  • Scoped, least privilege access to HydraDB resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
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