MCP

Endpoint:

https://api.hookmyapp.com/mcp

Authentication

Choose the auth option your MCP client supports:

Sign in from your MCP client: add the server by URL and sign in when prompted (for example /mcp in Claude Code). No API key needed.
HookMyApp CLI (Claude Code): hookmyapp login configures the MCP server automatically, with no extra setup.
API key: create an API key in HookMyApp and pass it as a header.

Accepted API key headers:

Authorization: Bearer hmok_...

X-API-Key: hmok_...

Use Authorization: Bearer for bearer-token clients. Use X-API-Key when your MCP client lets you configure custom headers.

Connect

claude mcp add --transport http hookmyapp https://api.hookmyapp.com/mcp

Run /mcp, pick hookmyapp, and approve the sign-in in your browser.

HookMyApp CLI (Claude Code)

If you use the HookMyApp CLI, MCP is already configured. hookmyapp login sets it up. To repair or re-run it:

hookmyapp mcp install --agent claude
hookmyapp doctor

MCP tools load when a session starts, so restart Claude Code after installing. Until then, every operation works through the hookmyapp CLI.

API key

Set your HookMyApp API key:

export HOOKMYAPP_API_KEY="hmok_..."

codex mcp add hookmyapp --url https://api.hookmyapp.com/mcp --bearer-token-env-var HOOKMYAPP_API_KEY

claude mcp add --transport http hookmyapp https://api.hookmyapp.com/mcp \
  --header "Authorization: Bearer $HOOKMYAPP_API_KEY"

{
  "mcpServers": {
    "hookmyapp": {
      "url": "https://api.hookmyapp.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:HOOKMYAPP_API_KEY}"
      }
    }
  }
}

Use X-API-Key instead

Codex CLI has no --header flag, so X-API-Key goes in ~/.codex/config.toml. For Cursor and Claude Code, swap the header.

[mcp_servers.hookmyapp]
url = "https://api.hookmyapp.com/mcp"
env_http_headers = { "X-API-Key" = "HOOKMYAPP_API_KEY" }

claude mcp add --transport http hookmyapp https://api.hookmyapp.com/mcp \
  --header "X-API-Key: $HOOKMYAPP_API_KEY"

{
  "mcpServers": {
    "hookmyapp": {
      "url": "https://api.hookmyapp.com/mcp",
      "headers": {
        "X-API-Key": "${env:HOOKMYAPP_API_KEY}"
      }
    }
  }
}

Tools

Tool	Use it for
`status`	Check auth, organization, scopes, and next steps. Also returns unacknowledged `notifications[]`
`acknowledge_notification`	Mark a notification from `status` `notifications[]` as seen, after relaying it to a human. Idempotent
`list_workspaces`	List workspaces and customers
`create_workspace`	Create a workspace
`delete_workspace`	Delete a workspace (org admin; team and customer alike). Deletes it outright when it has no channels and no usage history; otherwise deprecates it, disconnecting its channels and keeping history for stats and billing. Refuses the organization’s last workspace
`list_customers`	List customers in the organization
`create_customer`	Create a customer
`list_channels`	List Instagram channels in a workspace
`get_channel`	Read Instagram channel details
`send_message`	Send an Instagram DM
`publish_instagram_media`	Publish an image, reel, story, or carousel and get back the media ID and permalink
`get_instagram_insights`	Read account or media metrics, with partial results when a metric is unavailable
`list_instagram_comments`	List comments on a post, or replies to a comment
`reply_instagram_comment`	Reply to a comment publicly, or privately as a DM
`moderate_instagram_comment`	Hide, unhide, or delete a comment, or turn commenting on or off for a post
`get_webhook_config`	Read a channel webhook destination
`get_hmac_secret`	Read a channel’s current webhook signing secret without rotating it
`set_webhook_destination`	Set a channel webhook destination
`clear_webhook_destination`	Clear a channel webhook destination
`rotate_hmac`	Rotate a channel webhook signing secret
`set_forwarding`	Enable or disable forwarding
`list_deliveries`	List delivery logs for a channel
`get_delivery`	Read one delivery log by channel + its `wd_` ID from `list_deliveries`
`get_org_usage`	Check organization usage for the current quota period
`get_alert_phone_status`	Check your alert phone and what it receives
`set_alert_phone`	Set your alert phone. Sends a 6-digit code to confirm it
`verify_alert_phone`	Confirm your alert phone with the code
`remove_alert_phone`	Remove your alert phone
`list_onboarding_links`	List customer onboarding links
`create_onboarding_link`	Create a customer onboarding link
`revoke_onboarding_link`	Revoke a customer onboarding link so it can no longer be used
`set_org_destination`	Set the default destination for customer channels
`apply_org_destination_to_channels`	Apply or clear the organization destination in bulk

If a tool asks you to reconnect the channel, reconnect once from the dashboard.

Examples

Ask your agent to check setup:

Use HookMyApp MCP to check my organization status and tell me the next action.

Ask your agent to inspect Instagram channels:

Use HookMyApp MCP to list my workspaces, then list the Instagram channels in the active workspace.

Ask your agent to send a DM:

Use HookMyApp MCP to send "Hello from HookMyApp" from Instagram channel ch_xxxxxxxx.

Ask your agent to publish a post:

Use HookMyApp MCP to publish https://example.com/photo.jpg to Instagram channel ch_xxxxxxxx with the caption "New drop".

Ask your agent to work the comment section:

Use HookMyApp MCP to list new comments on my latest Instagram post, reply to questions, and hide spam.

Project MCP vs docs MCP

Server	Endpoint	Use it for
Project MCP	`https://api.hookmyapp.com/mcp`	Operating HookMyApp with the CLI-configured credential or an API key
Docs MCP	Not published yet	Documentation lookup only

Use the CLI when your agent has terminal access. Use MCP when your agent supports MCP and should operate HookMyApp directly.

Getting started

Sending & receiving

Publish & engage

Tools

API Reference

Authentication

Connect

HookMyApp CLI (Claude Code)

API key

Use X-API-Key instead

Tools

Examples

Project MCP vs docs MCP

​Authentication

​Connect

​Sign in from your client

​HookMyApp CLI (Claude Code)

​API key

​Use X-API-Key instead

​Tools

​Examples

​Project MCP vs docs MCP

Authentication

Connect

Sign in from your client

HookMyApp CLI (Claude Code)

API key

Use X-API-Key instead

Tools

Examples

Project MCP vs docs MCP