Skip to content
HornetHive
Start free

MCP server

HornetHive's Model Context Protocol server for Claude, Cursor and other AI agents: connecting a client, what each tool does, the scopes keys need, and how agents read data.

Server and keys

HornetHive's Model Context Protocol server is at https://mcp.hornethive.io, over Streamable HTTP. It lets an AI agent such as Claude, Cursor or Codex manage your databases with an API key, sent as Authorization: Bearer <key>. MCP is on the plans that include it; see pricing.

The key decides what the agent can do. A read key is offered only the read tools; a write key also gets the tools that create, delete and sync. A key limited to one database sees and acts on that database alone, and cannot create one. Give an agent the narrowest key that does the job.

Connecting a client

Most clients take the URL and a header. In Claude Code use claude mcp add; in Cursor, Claude Desktop and others add the server to their MCP configuration file. The older address, https://hornethive.io/mcp, also still works.

claude mcp add --transport http hornethive https://mcp.hornethive.io \
  --header "Authorization: Bearer YOUR_API_KEY"

# mcp.json (Cursor, Claude Desktop, others)
{
  "mcpServers": {
    "hornethive": {
      "type": "http",
      "url": "https://mcp.hornethive.io",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Tools

ToolScopeDoes
list_databasesreadYour databases; a key limited to one database sees only that one.
get_databasereadOne database's status, plan features and connection details.
list_regionsreadThe regions a database can be created in, and which have room now.
list_tablesreadThe tables in a database's public schema.
describe_tablereadColumns, types, defaults, primary and foreign keys, indexes and estimated rows.
get_database_statsreadSize, connections, cache hit ratio, transactions, rows read and written.
get_connection_stringreadPooled and direct connection strings, password masked; on plans with direct connections.
create_databasewriteCreate a database: a label, and optionally a region and a password.
delete_databasewriteDelete a database. It cannot be undone.
sync_graphqlwriteMake new or changed tables available over GraphQL.

Reading and writing data

No tool reads or writes rows. The agent finds the tables with list_tables and describe_table, then uses the same key on the REST API or GraphQL, or, if it has a terminal, psql with the connection string on plans with direct connections.

Calls and limits

Each tool call counts against your plan's monthly calls, like a REST or GraphQL request. A refused key answers 401, and a plan without MCP 403, before any tool runs; a tool the key's scope does not allow returns an error naming the scope it needs.