> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poix.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Connect AI clients to YouTube data through the Poix MCP server

The Poix MCP (Model Context Protocol) server lets AI assistants and agentic tools — Claude, ChatGPT, Cursor, and others — call the Poix API directly as tools, without you writing any integration code. Ask your assistant to search YouTube, pull video or channel details, fetch comments, or grab captions, and it will call the right tool automatically.

## Endpoint

The MCP server is available over **Streamable HTTP** at a single fixed URL:

```
https://mcp.poix.io
```

Point any MCP-compatible client at this URL and it will discover the full set of available tools (see [Tool Reference](/mcp/tools)) via the standard MCP `tools/list` handshake — no separate SDK or client library required.

<Note>
  The Poix MCP server supports both a `poix-` bearer Token (the same one you use for REST API requests) and browser-based OAuth sign-in for clients that support native connectors, like Claude and ChatGPT. See [Authentication](/mcp/authentication) for details on both.
</Note>

## Connect a client

Pick your client below for step-by-step setup instructions.

<CardGroup cols={2}>
  <Card title="Claude Desktop" icon="desktop" href="/mcp/clients/claude-desktop">
    Add as a connector, sign in with OAuth
  </Card>

  <Card title="Claude Code" icon="terminal" href="/mcp/clients/claude-code">
    Add Poix with a single `claude mcp add` command
  </Card>

  <Card title="ChatGPT" icon="comment-dots" href="/mcp/clients/chatgpt">
    Add as a custom connector in Developer mode (OAuth)
  </Card>

  <Card title="Cursor" icon="mouse-pointer" href="/mcp/clients/cursor">
    Configure Poix in `mcp.json`
  </Card>

  <Card title="Codex" icon="robot" href="/mcp/clients/codex">
    Add Poix with `codex mcp add` (TOML `config.toml`)
  </Card>

  <Card title="VS Code" icon="laptop-code" href="/mcp/clients/vscode">
    Configure Poix in `mcp.json`
  </Card>

  <Card title="Gemini" icon="sparkles" href="/mcp/clients/gemini">
    Add Poix as a Streamable HTTP MCP server
  </Card>

  <Card title="Hermes" icon="server" href="/mcp/clients/hermes">
    Add Poix as a Streamable HTTP MCP server
  </Card>
</CardGroup>

## Next steps

1. [Create a Token](/mcp/authentication) in the Dashboard if you don't have one yet.
2. Follow the setup guide for your client from the list above.
3. Explore the full [Tool Reference](/mcp/tools) to see what your assistant can do.