MCP docs

MCP server reference. The MCP server is not live yet - it is in private pilot and this page describes the coming interface accurately, not a running service. Email adagentzteam@gmail.com to join the pilot.

One server, any agent

The AdAgentz MCP server speaks streamable HTTP, so any MCP-capable agent can use it with a single entry in its config. For any agent. Any platform.

Config (preview)

{"mcpServers":{"adagentz":{"url":"https://mcp.adagentz.com/mcp","headers":{"X-Api-Key":"your-key"}}}}

URL reserved, not yet serving. Sandbox keys first, production keys at public launch.

Tools for hosts

request_ad - request a labelled sponsored suggestion for the person's current question. Pass the topic only. Returns one ad or none; sensitive contexts return none.

report_feedback - report shown, clicked, dismissed or complained.

get_earnings - aggregate host earnings and payout status.

Tools for advertisers

create_campaign - draft a campaign from site, goal and budget cap. Always paused at creation.

approve_campaign - lock the exact draft after claim verification.

pause_campaign - stop delivery immediately.

get_report - aggregate outcomes only.

Same rules

One ad per answer, frequency caps, no profiles, no sensitive-context ads, no conversation access for advertisers. See the Content policy.