adspirer-mcp

Calling the Adspirer MCP hub

Adspirer exposes 20 top-level tools. Six of them are routers that stand in front of hundreds of platform tools. Calling a platform tool by its own name does not work — it is not in the tool list. Read this before your first tool call.

The tool surface

Call these directly, by name:

Tool	Use it for
start_here	New or unsure user. Free.
search_tools	"Which tool does X?" Semantic search over every tool.
get_tool_schema	Exact parameters for a tool, before you call it.
get_connections_status	Which ad accounts are connected, and their health. Free.
get_usage_status	Plan, quota, usage this period. Free.
switch_primary_account	Change which account is active.
get_campaign_performance	Google Ads performance.
get_meta_campaign_performance	Meta (Facebook/Instagram) performance.
audit_conversion_tracking	Conversion-tracking health across platforms.
echo_test	Connectivity check. Free.

These are routers. Never call their inner tools by name:

google_ads · meta_ads · linkedin_ads · tiktok_ads · amazon_ads · chatgpt_ads · monitoring_and_reporting · community_plugins · google_analytics · klaviyo

The router two-step

Every router takes the same three fields: action, tool_name, arguments.

Step 1 — discover. Always first. Never costs quota.

{ "action": "list_tools" }

Returns every tool on that platform with its full parameter schema.

Step 2 — execute. Use an exact tool_name from step 1.

{
  "action": "execute",
  "tool_name": "list_tiktok_campaigns",
  "arguments": { "advertiser_id": "7012345678901234567" }
}

Rules

• action: "execute" without a tool_name is invalid. It returns an error. Do not retry the same call — go back to list_tools and read the real tool name.
• Never pass a platform tool name as action. action is only ever "list_tools" or "execute".
• search_tools and get_tool_schema are top-level. Call them directly when they are in your tool list. If your client does not list get_tool_schema, call it through any platform router: google_ads with action: "execute", tool_name: "get_tool_schema", arguments: {"tool_names": [...]}. It returns the same schema. Never stop because it is missing.
• Never guess a tool name or a parameter. If you are unsure, call list_tools or get_tool_schema.