MCP Tools

Tools exposed by the buyer MCP server (ad_buyer.interfaces.mcp_server), enumerated from the live FastMCP registry.

Total: 43 tools

Tool	Description
approve_or_reject	Approve or reject a pending approval request.
check_brand_safety	Evaluate page or ad-creative content for brand-safety risk. Classifies content into IAB categories and flags sensitive categories (gambling, adult, etc.). Returns safe/unsafe verdict, risk level (low/medium/high), and flagged categories.
check_pacing	Check budget pacing for a campaign.
classify_content	Classify page or ad-creative content into IAB v3.0 taxonomy categories using Mixpeek. Supply text content to classify. Returns ranked IAB category matches with hierarchical paths (e.g. Sports > American Football) and confidence scores for contextual targeting.
compare_sellers	Compare pricing and capabilities across multiple sellers.
complete_wizard_step	Complete a wizard step with the given configuration.
contextual_search	Search indexed ad inventory using a Mixpeek retriever pipeline. Pipelines can combine multimodal search, brand-safety filtering, IAB taxonomy enrichment, and reranking. Returns matching inventory with relevance scores and enriched metadata.
create_api_key	Store or replace an API key for a seller integration.
create_deal_manual	Manually create a single deal entry in the portfolio.
create_template	Create a new deal or supply path template.
discover_sellers	Discover available seller agents from the IAB AAMP registry.
get_campaign_report	Generate a campaign performance report.
get_campaign_status	Get detailed status of a specific campaign.
get_config	Get the current buyer agent configuration.
get_deal_performance	Get performance metrics for a specific deal.
get_negotiation_status	Check the status of a specific negotiation.
get_order_status	Get detailed status of a specific order.
get_pacing_report	Get budget pacing report for a campaign.
get_portfolio_summary	Get aggregate statistics and summary for the deal portfolio.
get_seller_media_kit	Fetch a specific seller's media kit with inventory and pricing.
get_setup_status	Check the current setup and configuration state of the buyer agent.
get_wizard_step	Get detailed information about a specific wizard step.
health_check	Check the health of buyer agent services.
import_deals_csv	Import deals from CSV data into the portfolio.
import_deals_ssp	Import deals from a specified SSP connector into the deal portfolio.
inspect_deal	Get detailed information on a specific deal.
instantiate_from_template	Create a deal from a deal template with optional overrides.
list_active_negotiations	List all active/pending negotiations.
list_api_keys	List configured API keys for seller integrations.
list_campaigns	List all campaigns with optional status filter.
list_deals	List deals in the portfolio with optional filters.
list_orders	List all orders with optional status filter.
list_pending_approvals	List approval requests that are awaiting a decision.
list_ssp_connectors	List available SSP connectors and their configuration status.
list_templates	List available deal and supply path templates.
review_budgets	Review budget allocation and spend across all campaigns.
revoke_api_key	Revoke (remove) an API key for a seller integration.
run_setup_wizard	Run the setup wizard and get the current status of all steps.
search_deals	Search deals in the portfolio by free-text query.
skip_wizard_step	Skip a wizard step, applying its sensible defaults.
start_negotiation	Initiate a negotiation with a seller within the demo ecosystem.
test_ssp_connection	Test connectivity to a specific SSP connector.
transition_order	Trigger an order state transition.