{"schema_version":"2026-06-13","provider":"OSPEA","auth":{"type":"bearer","workspace_scope":"workspace_id path parameter","permissions":"Workspace data endpoints require authenticated OSPEA access. Agents must act on behalf of an authorized workspace user.","note":"Read report endpoints before write actions. Mutations may consume provider credits or alter workspace tracking setup."},"mcp":{"status":"planned","description":"OSPEA should expose MCP tools for report retrieval, prompt library operations, scan status, and first-party import validation."},"tools":[{"id":"ai_visibility_share_of_voice","status":"available","method":"GET","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/share-of-voice","input_schema":{"days":"integer 1..365","start_date":"YYYY-MM-DD optional","end_date":"YYYY-MM-DD optional","platforms":"repeatable string query parameter optional","prompt_clusters":"repeatable string query parameter optional"},"output":"Weekly entity share-of-voice by platform, prompt cluster, source class, citation class, success count, failure count, mentions, citations, and visibility score.","safe_for_agents":true,"mutates_state":false},{"id":"weekly_aio_report","status":"available","method":"GET","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/weekly-aio-report","input_schema":{"days":"integer 1..365","start_date":"YYYY-MM-DD optional","end_date":"YYYY-MM-DD optional"},"output":"Unified weekly AIO report joining OSPEA AI scans, Google Search Console, and Bing AI Performance imports.","safe_for_agents":true,"mutates_state":false},{"id":"weekly_aio_report_export","status":"available","method":"GET","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/weekly-aio-report/export","input_schema":{"format":"csv or json","days":"integer 1..365","start_date":"YYYY-MM-DD optional","end_date":"YYYY-MM-DD optional"},"output":"Downloadable weekly AIO report export.","safe_for_agents":true,"mutates_state":false},{"id":"prompt_library","status":"available","method":"GET/POST/PATCH/DELETE","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/library","output":"SavedPrompt rows used by repeatable OSPEA AI visibility scans.","safe_for_agents":"read endpoints are safe; writes require user authorization","mutates_state":"POST/PATCH/DELETE"},{"id":"competitor_tracking","status":"available","method":"GET/POST/PATCH/DELETE","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/competitors","output":"Tracked competitor entities used in AI visibility scans and share-of-voice reporting.","safe_for_agents":"read endpoints are safe; writes require user authorization","mutates_state":"POST/PATCH/DELETE"},{"id":"manual_visibility_scan","status":"available","method":"POST","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/scan","output":"Queues a workspace visibility scan using enabled providers. Claude web-search scans are opt-in because they consume higher provider budget.","safe_for_agents":false,"mutates_state":true,"guardrails":["respect scan cadence","confirm workspace owner approval","check scan/status before retrying"]},{"id":"visibility_scan_status","status":"available","method":"GET","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/scan/status","output":"Refresh-safe scan progress with expected snapshot total, latest update, and progress percentage.","safe_for_agents":true,"mutates_state":false},{"id":"bing_ai_performance_import","status":"available","method":"POST","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/first-party/bing-ai-performance/import","output":"Imports exported Bing Webmaster Tools AI Performance rows as first-party citation data for weekly AIO reporting.","safe_for_agents":false,"mutates_state":true,"guardrails":["validate row dates","preserve source filename","do not fabricate first-party metrics"]},{"id":"geo_audit","status":"available","method":"GET","endpoint":"https://api.ospea.io/api/v1/aio/geo-audit","input_schema":{"url":"website URL to audit, e.g. https://example.com"},"output":"Public agent-readiness and GEO audit checks for a website.","safe_for_agents":true,"mutates_state":false}],"examples":[{"task":"Read Ripli weekly share of voice","method":"GET","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/share-of-voice?days=7","expected_use":"Summarize brand visibility, competitor share, source classes, and failed provider attempts."},{"task":"Export a weekly AIO report","method":"GET","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/weekly-aio-report/export?format=csv&days=7","expected_use":"Download report evidence for a weekly client update."},{"task":"Check whether a scan is still running","method":"GET","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/scan/status","expected_use":"Poll before triggering another scan."}]}