Skip to content

Agents · MCP + API

Connect your agent to Hookbird

One MCP server, one API. Your agent can read your brand, write and score hooks, generate posts in Studio (it quotes the credit price first), and schedule them to your channels.

MCP server URL (sign in with OAuth)

https://app.hookbird.ai/api/mcp-oauth-dynamic
~/brand — claude

$

Claude Code

MCP

Add Hookbird as a remote MCP server, then sign in once in the browser. Prefer a key? Hookbird → Agents gives the --header version.

  1. 1Run the command in your terminal
  2. 2Type /mcp in Claude Code, pick hookbird and sign in
bash
claude mcp add --transport http hookbird https://app.hookbird.ai/api/mcp-oauth-dynamic

Claude (desktop & web)

Connector

Add a custom connector with the Hookbird MCP URL.

  1. 1Settings → Connectors → Add custom connector
  2. 2Name it Hookbird and paste the URL
  3. 3Click Connect and approve access
text
https://app.hookbird.ai/api/mcp-oauth-dynamic

ChatGPT

Connector

Use the connector URL in ChatGPT’s developer mode.

  1. 1Settings → Apps & Connectors → Advanced → Developer mode
  2. 2Create connector, paste the URL, authentication: OAuth
  3. 3Enable it in a chat from the + menu
text
https://app.hookbird.ai/api/mcp-oauth-dynamic

OpenClaw

MCP

Register the server and log in; your claw gets the Hookbird tools. A ready-made Hookbird skill teaches it the workflow.

  1. 1Run both commands
  2. 2Ask: “write 5 hooks for my brand and score them”
bash
openclaw mcp add hookbird --url https://app.hookbird.ai/api/mcp-oauth-dynamic --transport streamable-http --auth oauth
openclaw mcp login hookbird

Hermes Agent

MCP

Add Hookbird to your Hermes config, with the Hookbird skill for the workflow.

  1. 1Add to ~/.hermes/config.yaml
  2. 2Run hermes mcp login hookbird, then /reload-mcp in the chat
yaml
# ~/.hermes/config.yaml
mcp_servers:
  hookbird:
    url: "https://app.hookbird.ai/api/mcp-oauth-dynamic"
    auth: oauth

Grok (xAI API)

MCP

Pass Hookbird as a remote MCP tool in an xAI Responses API request; Grok calls the tools server-side.

  1. 1Copy your API key from Hookbird → Agents
  2. 2Add the tool to your request
json
{
  "model": "grok-4.7",
  "input": "Score this hook: POV: 11pm, your accountant wants 43 receipts",
  "tools": [
    {
      "type": "mcp",
      "server_label": "hookbird",
      "server_url": "https://app.hookbird.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer $HOOKBIRD_API_KEY"
      }
    }
  ]
}

Public API & Node SDK

API

Plain HTTPS + JSON: score and write hooks, read the brand, run Studio, schedule posts. Or npm i @hookbird/node.

  1. 1Copy your API key from Hookbird → Agents
  2. 2Send it as the Authorization header
bash
curl -X POST https://app.hookbird.ai/api/public/v1/hooks/score \
  -H "Authorization: $HOOKBIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"POV: 11pm, your accountant wants 43 receipts"}'

What your agent can do

These are the tool names your agent sees. Every post still needs your confirmation.

  • hookbird.brand_profile

    Read the brand: voice, products, audiences, competitors. brand_read builds it from a URL.

  • hookbird.hooks_generate

    Write hooks for a topic and audience, each scored 0-100, best first.

  • hookbird.hooks_score

    Score your own hook with strengths, fixes and a stronger rewrite.

  • hookbird.studio_generate

    Make a wall of text, slideshow, UGC video or voiceover. studio_formats shows the credit price first.

  • hookbird.strategy_plan

    Plan weeks of posts: dates, channels, formats, hooks, as calendar drafts.

  • hookbird.radar_ads

    Competitor ads and how long they have run. radar_trends: hashtags, sounds, creators.

  • hookbird.benchmarks

    Your last 30 days against your niche median and top 10%, with sources.

  • hookbird.credits_balance

    Credits left. Hooks, brand, plans and research are free; only Studio spends credits.

  • hookbird.integrationSchedulePostTool

    Schedule or draft a post to any connected channel, after you confirm.

Your next post needs a better hook.

7 days free with ◆ 50 credits. Paste your URL and see what Hookbird writes.

Start free See pricing