{"openapi":"3.1.0","info":{"title":"StoryVid MCP","description":"AI-powered tools for video audits, ad transparency research, and marketing intelligence.","version":"1.0.0"},"servers":[{"url":"https://api.storyvid.com","description":"Production Server"}],"paths":{"/tools/ping_test":{"post":{"tags":["Tools"],"summary":"Ping Test","description":"Simple test tool to confirm tool discovery is working.","operationId":"ping_test","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PingRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tools/search_google_ads_transparency":{"post":{"tags":["Tools"],"summary":"Search Google Ads Transparency","description":"Search or retrieve public Google Ads Transparency Center information for a company/brand.","operationId":"search_google_ads_transparency","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchGoogleAdsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tools/capture_website_screenshot":{"post":{"tags":["Tools"],"summary":"Capture Website Screenshot","description":"Capture a screenshot of a website for use in a branded video audit report.","operationId":"capture_website_screenshot","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaptureScreenshotRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"tags":["System"],"summary":"Health Check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp":{"get":{"tags":["System"],"summary":"MCP Information Endpoint","description":"Endpoint for humans or agents to check the status of the MCP / REST API.","operationId":"mcp_info_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"CaptureScreenshotRequest":{"properties":{"url":{"type":"string","title":"Url","description":"URL to capture."},"full_page":{"type":"boolean","title":"Full Page","description":"Whether to capture the full page.","default":false}},"type":"object","required":["url"],"title":"CaptureScreenshotRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PingRequest":{"properties":{"message":{"type":"string","title":"Message","description":"Optional message to echo back.","default":"hello"}},"type":"object","title":"PingRequest"},"PingResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"source":{"type":"string","title":"Source"}},"type":"object","required":["status","message","source"],"title":"PingResponse"},"SearchGoogleAdsRequest":{"properties":{"brand_name":{"type":"string","title":"Brand Name","description":"Brand or company name to search."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country location to filter by."},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain","description":"Domain to filter by."}},"type":"object","required":["brand_name"],"title":"SearchGoogleAdsRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}