Hookbird

npx add-mcp 'https://app.hookbird.ai/mcp-oauth-dynamic'

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.

~/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

claude mcp add --transport http hookbird https://app.hookbird.ai/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

https://app.hookbird.ai/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

https://app.hookbird.ai/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”

openclaw mcp add hookbird --url https://app.hookbird.ai/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

# ~/.hermes/config.yaml
mcp_servers:
  hookbird:
    url: "https://app.hookbird.ai/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

{
  "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

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.