MCP Server

WebsiteIQ

io.github.OsbornVentures/websiteiq
Business & Operations Developer Tools Public & reachable MCP 2025-11-25

What this MCP does

Runs robots-compliant website audits, provides crawl estimates and quotes, and returns audit status and reports.

audit_url
Start a WebsiteIQ audit
Starts the free bounded, robots-compliant audit of one public HTTP(S) page. No account, email, or contact consent is required. One free audit is allowed per requester IP and per target website each day. When payment is available, an abuse-limited call returns the exact sitemap-priced x402 PaymentRequired result and accepts a compatible retry through _meta['x402/payment']; otherwise it returns a quote preview. WebsiteIQ never pays target sites and never bypasses robots.txt.
Open world
Input schema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'Public website URL to audit.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['ok', 'id', 'status', 'pageCap', 'statusUrl', 'reportUrl'], 'properties': {'id': {'type': 'string'}, 'ok': {'type': 'boolean'}, 'status': {'type': 'string'}, 'pageCap': {'type': 'integer'}, 'reportUrl': {'type': 'string'}, 'statusUrl': {'type': 'string'}, 'retentionPolicy': {'type': 'string'}}}
delete_audit
Delete audit
Deletes the retained request metadata, generated report, and delivery record.
Destructive Idempotent
Input schema
{'type': 'object', 'required': ['id', 'accessToken'], 'properties': {'id': {'type': 'string'}, 'accessToken': {'type': 'string'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['id', 'deleted'], 'properties': {'id': {'type': 'string'}, 'deleted': {'type': 'boolean'}}}
estimate_audit
Get a whole-site audit quote
Before audit crawling, reads robots.txt and a bounded same-host sitemap tree—including namespaced, WordPress, and Yoast-style indexes—then returns page scope plus standard and white-label USDC quotes. Up to 10 pages cost $0.01 standard or $0.02 white-label; each additional page costs $0.001 or $0.002. A payable quote includes the quoteId required by start_paid_audit.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'Public website URL whose robots-permitted sitemap should be counted.'}, 'branding': {'type': 'object', 'required': ['agencyName', 'presenterName', 'phone', 'email', 'contactConsent'], 'properties': {'email': {'type': 'string', 'format': 'email'}, 'phone': {'type': 'string'}, 'ctaUrl': {'type': 'string', 'format': 'uri'}, 'ctaLabel': {'type': 'string'}, 'agencyName': {'type': 'string'}, 'presenterName': {'type': 'string'}, 'contactConsent': {'type': 'boolean', 'const': True}, 'marketingMessage': {'type': 'string'}}, 'description': 'Required when whiteLabel is true.', 'additionalProperties': False}, 'whiteLabel': {'type': 'boolean', 'default': False, 'description': 'Return the white-label quote as selectedQuote.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['ok', 'url', 'estimatedPages', 'estimateComplete', 'quoteStatus', 'standardQuote', 'whiteLabelQuote', 'selectedQuote', 'pricingStatus', 'pricingNotice', 'paymentStatus', 'quoteId', 'quotePayable'], 'properties': {'ok': {'type': 'boolean'}, 'url': {'type': 'string'}, 'quoteId': {'type': ['string', 'null']}, 'quoteStatus': {'type': 'string'}, 'quotePayable': {'type': 'boolean'}, 'paymentStatus': {'type': 'string'}, 'pricingNotice': {'type': 'string'}, 'pricingStatus': {'type': 'string'}, 'selectedQuote': {'type': 'object'}, 'standardQuote': {'type': 'object'}, 'estimatedPages': {'type': 'integer'}, 'quoteExpiresAt': {'type': ['string', 'null']}, 'whiteLabelQuote': {'type': 'object'}, 'estimateComplete': {'type': 'boolean'}}}
get_audit_status
Get audit status
Returns the privacy-filtered status of an audit. The access token returned by audit_url is required.
Read only Idempotent
Input schema
{'type': 'object', 'required': ['id', 'accessToken'], 'properties': {'id': {'type': 'string'}, 'accessToken': {'type': 'string'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['ok', 'id', 'status'], 'properties': {'id': {'type': 'string'}, 'ok': {'type': 'boolean'}, 'status': {'type': 'string'}, 'reportUrl': {'type': 'string'}}}
list_checks
List WebsiteIQ checks
Returns the current public audit categories and scoring caveat.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['checks', 'scoringNote'], 'properties': {'checks': {'type': 'array', 'items': {'type': 'object'}}, 'scoringNote': {'type': 'string'}}}
start_paid_audit
Pay for and start a quoted audit
Starts the exact robots-aware whole-site scope represented by a current quoteId. If payment is absent, returns an x402 v2 PaymentRequired result. A compatible MCP client retries with _meta['x402/payment']; WebsiteIQ verifies the required payment identifier, settles exact USDC, and returns the existing job on safe replay.
Open world Idempotent
Input schema
{'type': 'object', 'required': ['quoteId'], 'properties': {'quoteId': {'type': 'string', 'pattern': '^wiq_quote_[a-f0-9]{32}$'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['ok', 'id', 'status', 'quoteId', 'pageCap', 'statusUrl', 'reportUrl', 'payment'], 'properties': {'id': {'type': 'string'}, 'ok': {'type': 'boolean'}, 'status': {'type': 'string'}, 'pageCap': {'type': 'integer'}, 'payment': {'type': 'object'}, 'quoteId': {'type': 'string'}, 'reportUrl': {'type': 'string'}, 'statusUrl': {'type': 'string'}}}
Added
list_checks
Sept. 17, 2026, 12:45 p.m.
Added
delete_audit
Sept. 17, 2026, 12:45 p.m.
Added
get_audit_status
Sept. 17, 2026, 12:45 p.m.
Added
audit_url
Sept. 17, 2026, 12:45 p.m.
Added
start_paid_audit
Sept. 17, 2026, 12:45 p.m.
Added
estimate_audit
Sept. 17, 2026, 12:45 p.m.