Publisher Revenue Audit MCP

Public CLI and stdio MCP adapter for running a hosted publisher revenue-readiness screen and starting the Sulvo signup flow.

The npm package is intentionally thin. The hosted audit service performs the private analysis server-side; this package ships only the adapter code, output formatting, remote client, and unauthenticated signup helpers.

Install

npx -y -p publisher-revenue-audit-mcp publisher-revenue-audit example.com

For MCP desktop clients that use stdio:

{
  "mcpServers": {
    "publisher-revenue-audit": {
      "command": "npx",
      "args": ["-y", "-p", "publisher-revenue-audit-mcp", "publisher-revenue-audit-mcp"]
    }
  }
}

Clients that support hosted MCP can connect directly to:

https://publisher-revenue-audit.sulvo.com/mcp

CLI

publisher-revenue-audit example.com --json
publisher-revenue-audit audit example.com --max-pages 2 --markdown
publisher-revenue-audit apply example.com --email [email protected]

Signup commands:

publisher-revenue-audit signup start example.com --email [email protected]
SULVO_SIGNUP_PASSWORD="choose-a-strong-password" \
  publisher-revenue-audit signup create-account example.com \
  --email [email protected] \
  --first-name Jane \
  --last-name Doe \
  --password-env SULVO_SIGNUP_PASSWORD \
  --monthly-pageviews 125000
publisher-revenue-audit signup company --user-id returned-user-id --website example.com --country "United States"
publisher-revenue-audit signup ads-txt --user-id returned-user-id
publisher-revenue-audit signup verify-ads-txt --user-id returned-user-id
publisher-revenue-audit signup status --user-id returned-user-id
publisher-revenue-audit signup documents --user-id returned-user-id --adsense-file ./policy-center.png --earnings-file ./earnings.pdf --create-tagless-unit false

Audit options:

• --json, --markdown, or --markdown-and-json
• --compact
• --max-pages 1..5
• --include-evidence or --no-evidence
• --api-url URL
• --api-timeout-ms MS
• --out path

Signup options:

• --json or --markdown
• --signup-api-url URL
• --signup-timeout-ms MS
• --out path

MCP Tools

The public stdio MCP server exposes:

• run_publisher_revenue_audit
• apply_for_sulvo_account
• start_sulvo_signup
• create_sulvo_signup_account
• update_sulvo_signup_company
• get_sulvo_signup_ads_txt
• verify_sulvo_signup_ads_txt
• get_sulvo_signup_status
• submit_sulvo_signup_documents

The public MCP server does not read arbitrary local files. Document review from MCP returns dashboard instructions. The CLI document command reads only explicit paths supplied by the operator and enforces file-count and byte limits before upload.

Distribution Boundary

The npm package does not include the private local audit engine, private analysis modules, hosted HTTP backend, authenticated account/report clients, source maps, tests, or private docs.

Public installs call the hosted audit endpoint. Current audit and signup-application flows do not require API keys, OAuth, or a Sulvo login. Account approval remains a separate Sulvo review process before any production inventory work.

Development

npm run build
npm test
npm run smoke:cli
npm run smoke:mcp
npm run check:public-package