mcp server

audit

Publisher revenue audit: ads.txt and ad-stack checks, Sulvo onboarding, and Boost ad-block recovery

Description as published by the maintainer. Source

• version 0.2.1
• active

active — Registry entry last updated 2026-07-28.

What this server can do

37 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

apply_for_sulvo_account(email, domain, outputFormat)

Submit an unauthenticated Sulvo account application lead through the current signup API. Audit tools remain available without login, API key, or OAuth; ad-unit generation should wait for Sulvo account approval. Required: domain, email.

attach_sulvo_revenue_audit(input, workspaceId, outputFormat, idempotencyKey)

Attach a current public revenue audit artifact. Input requires expectedVersion and auditArtifactId. Required: workspaceId.

connect_sulvo_backup_provider(input, workspaceId, outputFormat, idempotencyKey)

Return the GAM or AdSense authorization URL. Input requires provider set to gam or adsense. Required: workspaceId.

create_sulvo_ad_unit(size, type, custom, domain, focusedAd, placement, outputFormat)

Create a Sulvo ad unit for an approved publisher. Requires SULVO_API_KEY (with the inventory:write scope) in the server environment, never passed as an argument — an account owner mints a write-scoped key in the Sulvo dashboard (Account Settings -> API key). The Sulvo account must be approved; the backend rejects unapproved accounts. Returns the created unit id and container root. Required: domain, type.

create_sulvo_auto_sticky_units(domain, adTypes, outputFormat)

Create Sulvo auto-sticky ad units for an approved publisher. Requires SULVO_API_KEY (with the inventory:write scope) in the server environment. Required: domain, adTypes.

create_sulvo_interstitial_units(domain, adTypes, outputFormat)

Create Sulvo interstitial ad units (tagless) for an approved publisher. Requires SULVO_API_KEY (with the inventory:write scope) in the server environment. Required: domain, adTypes.

create_sulvo_signup_account(email, phone, domain, lastName, password, firstName, utmMedium, utmSource, mixpanelId, utmContent, outputFormat, monthlyPageviews)

Run normal Sulvo signup step 2: create the pending Sulvo user/account. The current signup backend requires a password before the account can continue to ads.txt and review. Required: domain, email, firstName, lastName, password, monthlyPageviews.

delete_sulvo_ad_unit(adId)

Delete a Sulvo ad unit by id for an approved publisher. Requires SULVO_API_KEY (with the inventory:write scope) in the server environment. The key's account must own the unit; the backend enforces ownership. Required: adId.

delete_sulvo_advanced_report(reportId)

Delete a saved Sulvo advanced report by id. Requires SULVO_API_KEY (with the reports:write scope) in the server environment. Required: reportId.

get_publisher_monetization_benchmarks(vertical)

Get comparative yield and CPM industry benchmarks by publisher vertical to compare standard stacks (AdSense and managed wrappers) against Sulvo Premium Ad Units.

get_publisher_revenue_audit_checklist

Return the public checklist and interpretation notes used by the publisher revenue-readiness screen.

get_sulvo_activation_smoke_status(input, workspaceId, outputFormat, idempotencyKey)

Return active-probe, real-page, and remediation status for the latest activation attempt. Required: workspaceId.

get_sulvo_installation_instructions(input, workspaceId, outputFormat, idempotencyKey)

Return installation values for the locked revision. Input is empty. Required: workspaceId.

get_sulvo_report(end, start, adRoots, domains, adProvider, reportType, directBidder, outputFormat)

Fetch a Sulvo report (read-only). Requires SULVO_API_KEY in the server environment (a publisher generates it in the dashboard: Account Settings -> API key). Covers by-date, by-date-and-ad-unit, by-domain-and-ad-unit, bot-filtering, bot-scores, invalid-activity, direct-bidder-analysis, and ad-units-by-domain. Required: reportType.

get_sulvo_revenue_onboarding_status(workspaceId, outputFormat)

Return the backend-owned journey stage, readiness dimensions, and one next best action. Required: workspaceId.

get_sulvo_signup_ads_txt(userId, outputFormat)

Run normal Sulvo signup step 4a: fetch the ads.txt lines the publisher must add for site ownership verification. Required: userId.

get_sulvo_signup_status(userId, outputFormat)

Return the current signup status capability. The current signup API has no public approval-status endpoint, so this tool reports that limitation instead of guessing approval state. Required: userId.

import_sulvo_backup_units(input, workspaceId, outputFormat, idempotencyKey)

Import connected provider units. Input requires provider and expectedVersion. Required: workspaceId.

list_sulvo_advanced_reports(outputFormat)

List the saved Sulvo advanced reports for the account. Requires SULVO_API_KEY (with the reports:read scope) in the server environment.

lock_sulvo_placement_revision(input, workspaceId, outputFormat, idempotencyKey)

Lock the exact mapped revision. Input requires expectedVersion and revisionId. Required: workspaceId.

map_sulvo_placement_backup(input, workspaceId, outputFormat, idempotencyKey)

Map a display placement backup. Input requires expectedVersion, stablePlacementId, provider, and providerId. Required: workspaceId.

review_sulvo_placement_recommendations(input, workspaceId, outputFormat, idempotencyKey)

Save accept, edit, or reject decisions. Input requires expectedVersion and decisions. Required: workspaceId.

rollback_sulvo_activation(input, workspaceId, outputFormat, idempotencyKey)

Return the workspace domain to publisher-owned backup-only serving. Required: workspaceId.

run_publisher_revenue_audit(domain, metrics, options, vertical)

Run a public publisher revenue-readiness screen using directional public evidence. Audits ad stacks, ads.txt hygiene, consent readiness, PageSpeed metrics, and unblocked premium ad unit opportunities (such as Sulvo) to recover lost yield. Required: domain.

run_sulvo_activation_preflight(input, workspaceId, outputFormat, idempotencyKey)

Run the complete bounded activation preflight for the locked workspace revision. Required: workspaceId.

save_sulvo_advanced_report(end, name, utms, start, adRoots, domains, reportId, timeZone, frequency, toAddress, dimensions, reportType, immediateRun, outputFormat, utmHourlyBreakdown)

Create/update a Sulvo advanced report (adUnit, dimensions, or customData), run immediately (emailed) or on a recurring schedule. Requires SULVO_API_KEY (with the reports:write scope) in the server environment. Note: advanced reports are delivered by email, not returned inline. Required: reportType, toAddress, immediateRun.

save_sulvo_placement_plan(input, workspaceId, outputFormat, idempotencyKey)

Save a placement revision. Input requires expectedVersion and payload. Required: workspaceId, input.

set_sulvo_onboarding_journey(input, workspaceId, outputFormat, idempotencyKey)

Set or change the journey intake answers on the workspace. Input requires expectedVersion plus at least one of mode, goal, retagTiming. Required: workspaceId.

start_sulvo_revenue_onboarding(goal, domain, retagTiming, outputFormat, idempotencyKey, auditArtifactId)

Create or resume a verified-account activation workspace after the public audit and signup steps. Required: domain.

start_sulvo_signup(email, domain, outputFormat, monthlyPageviews)

Run normal Sulvo signup step 1: verify the publisher domain and create the unauthenticated signup lead. Required: domain, email.

submit_sulvo_activation_workspace(input, workspaceId, outputFormat, idempotencyKey)

Submit the proven revision. Input requires expectedVersion and revisionId. Required: workspaceId.

submit_sulvo_signup_documents

Explains how to complete Sulvo signup document review. Document submission is done in Sulvo onboarding - upload monthly earnings proof or connect an AdSense account - not through this connector, which has no access to the user's local files.

submit_sulvo_site_for_approval(input, workspaceId, outputFormat, idempotencyKey)

Retag-after-approval journeys: submit the bare site for Google approval (ads.txt ownership only, no tags). Input requires expectedVersion. Required: workspaceId.

update_sulvo_signup_company(zip, city, state, userId, address, country, website, outputFormat, employeeCount, monthlyAdRevenue)

Run normal Sulvo signup step 3: save optional company information for a pending Sulvo signup. Required: userId.

verify_sulvo_placement_installation(input, workspaceId, outputFormat, idempotencyKey)

Verify every stable placement container and the inert loader for the locked revision. Required: workspaceId.

verify_sulvo_signup_ads_txt(userId, outputFormat)

Run normal Sulvo signup step 4b: verify whether the submitted publisher domain has the required Sulvo ads.txt lines. Required: userId.

verify_sulvo_site_ownership(input, workspaceId, outputFormat, idempotencyKey)

Verify the required ads.txt and inert Sulvo head-tag ownership evidence. Required: workspaceId.

Last successful function declaration observed on 2026-08-13. Source: https://publisher-revenue-audit.sulvo.com/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://publisher-revenue-audit.sulvo.com/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Website — https://sulvo.com
• npm: publisher-revenue-audit-mcp
• Remote endpoint (streamable-http) — https://publisher-revenue-audit.sulvo.com/mcp