HubAds MCP Server

MCP (Model Context Protocol) server that wraps the HubAds v1 REST API, enabling AI agents like Claude Code to manage projects, groups, inbound links, and domains programmatically.

Install & Register

Via npx (recommended)

claude mcp add hubads -e HUBADS_API_KEY=hub_live_v1_xxx -- npx -y hubads-mcp

From source (local development)

cd mcp && npm install

claude mcp add hubads-dev \
  -e HUBADS_API_KEY=hub_test_v1_xxx \
  -e HUBADS_BASE_URL=http://localhost:3000/api/v1 \
  -- npx tsx /absolute/path/to/hubads-co/mcp/server.ts

Publishing to npm

cd mcp
npm run build
npm publish

After publishing, npx -y hubads-mcp works from anywhere.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | HUBADS_API_KEY | Yes | — | API key (e.g. hub_live_v1_...) | | HUBADS_BASE_URL | No | https://hubads.co/api/v1 | API base URL |

Available Tools (19)

User

• get_user — Get authenticated user profile
• get_api_key_info — Get API key metadata

Domains

• list_domains — List custom domains
• get_domain — Get domain by UUID

Projects

• list_projects — List all projects
• create_project — Create a project
• get_project — Get project by UUID
• update_project — Update a project
• delete_project — Soft-delete a project

Groups

• list_groups — List WhatsApp groups in a project
• create_group — Add a group to a project
• get_group — Get group by UUID
• update_group — Update a group
• delete_group — Soft-delete a group

Inbound Links

• list_inbound_links — List inbound links in a project
• create_inbound_link — Create an inbound link
• get_inbound_link — Get inbound link by UUID
• update_inbound_link — Update an inbound link
• delete_inbound_link — Soft-delete an inbound link

API Documentation

• Interactive Swagger docs: https://hubads.co/docs
• OpenAPI spec: https://hubads.co/api/v1/openapi.json