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

# MCP overview

> Use KonbiniAPI directly from AI agents and coding assistants via the Model Context Protocol. No API calls, no headers — just ask.

KonbiniAPI is available as a hosted [MCP server](https://modelcontextprotocol.io) at `https://mcp.konbiniapi.com`. That lets AI agents like Claude, ChatGPT, Cursor, Codex, and Zed call KonbiniAPI directly without you writing integration code or running the server locally.

Once connected, your AI agent can fetch TikTok, Instagram, X, and Reddit data just by being asked. No manual API calls, no auth headers, no JSON parsing.

## What the agent can do

The MCP server exposes one typed tool per supported endpoint:

<CardGroup cols={2}>
  <Card title="Call typed tools directly" icon="bolt" href="/reference/mcp/tools/overview">
    Use tools like `instagram_get_user`, `tiktok_get_user_videos`, `x_get_post`,
    or `reddit_get_subreddit` directly in your client.
  </Card>

  <Card title="Project smaller payloads" icon="filter" href="/reference/mcp/tools/overview#projection-options">
    Use `projection_preset`, `data_fields`, and `item_fields` to keep tool
    results focused and save tokens.
  </Card>
</CardGroup>

## How it works

Connect your MCP-compatible client to `https://mcp.konbiniapi.com`, authorize it once, and then call KonbiniAPI tools directly from your agent. Most clients support OAuth. Some clients also let you connect with a KonbiniAPI API key instead.

Each successful endpoint-tool call uses the same credits as the matching direct REST API call and returns MCP metadata when available.

## Recommended connection modes

<CardGroup cols={2}>
  <Card title="Remote HTTP + OAuth" icon="cloud">
    Best option for most clients. Use the hosted MCP URL directly and sign in
    through the browser once.
  </Card>

  <Card title="Remote HTTP + API key" icon="key">
    For clients that support remote MCP but not OAuth yet. Keep the server
    remote and send your KonbiniAPI API key as a Bearer token header.
  </Card>
</CardGroup>

## Setup guides

Choose the client or tool you want to use with KonbiniAPI's hosted MCP server.
These guides are grouped by use case and focus on the easiest remote setup with
`https://mcp.konbiniapi.com`.

### Chat

<CardGroup cols={3}>
  <Card title="ChatGPT" icon="https://mintcdn.com/konbiniapi/hiwdiC8KJ_qhmpFa/icons/products/chatgpt.svg?fit=max&auto=format&n=hiwdiC8KJ_qhmpFa&q=85&s=c80e09a5fc75a79081f3861d2bac1760" href="/reference/mcp/setup/chatgpt" width="24" height="24" data-path="icons/products/chatgpt.svg">
    Set up with ChatGPT.
  </Card>

  <Card title="Claude" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/claude.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=4202dc85cfe011144bd5d1da31e9b574" href="/reference/mcp/setup/claude" width="1200" height="1200" data-path="icons/products/claude.svg">
    Set up with Claude Desktop or Claude.ai.
  </Card>

  <Card title="Custom agents" icon="code" href="/reference/mcp/setup/custom-agents">
    Connect your own agent or framework.
  </Card>
</CardGroup>

### Automation

If you use KonbiniAPI inside workflow builders or agent orchestration tools, use
the hosted MCP directly there too.

<CardGroup cols={3}>
  <Card title="Zapier" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/zapier.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=c3ab5fd40bf2bd1b93487580cf7af190" href="/reference/mcp/setup/zapier" width="16" height="16" data-path="icons/products/zapier.svg">
    Connect KonbiniAPI to Zapier with MCP Client.
  </Card>

  <Card title="n8n" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/n8n.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=78f5734cfc333e6f28ca31bb958d8c6b" href="/reference/mcp/setup/n8n" width="24" height="24" data-path="icons/products/n8n.svg">
    Use KonbiniAPI inside n8n workflows or AI agents.
  </Card>

  <Card title="Make" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/make.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=a8728b01fb3782f4c6c376af0fcd7812" href="/reference/mcp/setup/make" width="24" height="24" data-path="icons/products/make.svg">
    Call KonbiniAPI tools from Make scenarios and agents.
  </Card>

  <Card title="Pipedream" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/pipedream.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=f4b125b317080b7986b1eaf289ead630" href="/reference/mcp/setup/pipedream" width="600" height="600" data-path="icons/products/pipedream.svg">
    Add KonbiniAPI to Pipedream workflows and app integrations.
  </Card>
</CardGroup>

### Code

<CardGroup cols={3}>
  <Card title="Claude Code" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/claude-code.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=8e54ab0dcd431f11bc08c182e1ec8d34" href="/reference/mcp/setup/claude-code" width="16" height="16" data-path="icons/products/claude-code.svg">
    Set up with Claude Code.
  </Card>

  <Card title="Codex" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/codex.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=90bde550c09c53b44a64cebe0a92d4c4" href="/reference/mcp/setup/codex" width="1200" height="1200" data-path="icons/products/codex.svg">
    Set up with OpenAI Codex CLI or the Codex app.
  </Card>

  <Card title="Cursor" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/cursor.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=312b60a2663cfd1c5899c99ce311b039" href="/reference/mcp/setup/cursor" width="24" height="24" data-path="icons/products/cursor.svg">
    Set up with Cursor.
  </Card>

  <Card title="VS Code" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/visual-studio-code.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=1ce7fd752c94870d8a5231b62671e11d" href="/reference/mcp/setup/vscode" width="24" height="24" data-path="icons/products/visual-studio-code.svg">
    Set up with VS Code agent mode or GitHub Copilot.
  </Card>

  <Card title="Antigravity" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/antigravity.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=296c5c962ddad6bdd349fa4200472a2e" href="/reference/mcp/setup/antigravity" width="24" height="24" data-path="icons/products/antigravity.svg">
    Set up with Antigravity.
  </Card>

  <Card title="Gemini CLI" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/gemini.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=6890538e608c7a720d7e5575ec0ce9e9" href="/reference/mcp/setup/gemini-cli" width="24" height="24" data-path="icons/products/gemini.svg">
    Set up with the Gemini CLI.
  </Card>

  <Card title="Windsurf" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/windsurf.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=b26764e524adb1398822be69ae5bcc51" href="/reference/mcp/setup/windsurf" width="24" height="24" data-path="icons/products/windsurf.svg">
    Set up with Windsurf.
  </Card>

  <Card title="Cline" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/cline.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=4705f79a7409b50adbbde563c2ac4ed8" href="/reference/mcp/setup/cline" width="24" height="24" data-path="icons/products/cline.svg">
    Set up with the Cline VS Code extension.
  </Card>

  <Card title="Replit" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/replit.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=1f0527f8ffe897daea9c7298141eb1b6" href="/reference/mcp/setup/replit" width="24" height="24" data-path="icons/products/replit.svg">
    Set up with Replit Agent and Replit's MCP settings.
  </Card>

  <Card title="Zed" icon="https://mintcdn.com/konbiniapi/ZLghhhhdIecbHjry/icons/products/zed.svg?fit=max&auto=format&n=ZLghhhhdIecbHjry&q=85&s=67cda6733f8b0b4d33f3ee409ea17732" href="/reference/mcp/setup/zed" width="24" height="24" data-path="icons/products/zed.svg">
    Set up with Zed's agent panel and custom servers.
  </Card>
</CardGroup>
