Connect HEXBIRD

Connect an MCP client

Get more usage, frontier-model choice, and easier personal-data joins through an OAuth-capable MCP client.

For almost all ongoing use, MCP is the best way to use HEXBIRD. It uses less of your HEXBIRD quota than hosted web chat, so you can run substantially more investigations; it lets you use the latest frontier model available in your client; and it makes cross-correlation or joins with personal datasets and local files much easier.

HEXBIRD is a remote MCP server. Your client can discover its aviation query tools and documentation resources, then authenticate through OAuth without a manually issued long-lived token. If you want to try HEXBIRD immediately without configuring a client, browser chat is the fastest starting point.

Before you connect

You need a HEXBIRD account on a plan that includes MCP access and a client that supports remote Streamable HTTP plus OAuth. The server URL is:

text
https://hexbird.io/mcp

Claude Code

shell
claude mcp add hexbird --transport http https://hexbird.io/mcp

Run /mcp, choose hexbird, and complete the browser authorization flow.

Codex

shell
codex mcp add hexbird --url https://hexbird.io/mcp

Complete the OAuth flow when Codex opens the authorization page.

Other clients

In Cursor, Claude Desktop, ChatGPT Developer Mode, Gemini CLI, or another compatible client, add a remote MCP server with https://hexbird.io/mcp as its URL. The client should discover the authorization metadata and open a browser for consent.

Confirm the connection

Ask the client to list or describe its HEXBIRD tools. A working connection should expose aviation query tools and documentation resources.

For a useful end-to-end check, ask:

Using HEXBIRD, describe the available sources for reconstructing a historical flight. Do not run a broad archive query yet.

This verifies that the client can read the guidance before spending query capacity.

Working effectively over MCP

  • Ask the database to aggregate or filter instead of returning raw rows into model context.
  • Treat a capped result as incomplete, not as evidence that no additional rows exist.

Revoke a connection

Connected clients appear on your HEXBIRD account page. Revoke clients you no longer use or any authorization you do not recognize.