mudko
← docs

Agent integration

We serve 25 MCP tools at /api/mcpso any MCP-capable agent can run an end-to-end engagement on a user's behalf — scan a site, get a quote, buy, and receive the deliverables. This page is a quick-start for connecting; the machine-readable surfaces below carry the full, always-current schema.

Connect

Transport is JSON-RPC 2.0 over HTTP POST (MCP 2025-06-18). No API key is required to connect — OAuth is available for clients that want it (see /.well-known/oauth-authorization-server). List the tools:

curl -X POST https://mudko.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Call a tool (free scan example):

curl -X POST https://mudko.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":2,
       "params":{"name":"scan_site","arguments":{"url":"https://example.com"}}}'
What an agent can do here
  • Audit a site — run the agent-readiness scan, get a level 0-5 with per-check findings and remediation guidance, and re-verify after deploying.
  • Understand the business — vertical analysis, human-readable scan summaries, suggested agent capabilities for the site.
  • Get a quote and buy — request and refine a quote, compare tiers, verify our credentials, and complete checkout entirely in-session (Stripe invoice or x402/USDC).
  • Receive deliverables — fetch the agent-ready file bundle and citation reports. Paid tools take a bundle_key; without one they return the free starter files.
  • Leave a lead — capture contact details for human follow-up.

All tools (25)

  • analyze_business_vertical
  • check_bazaar_listing
  • clarifying_questions
  • create_bazaar_listing
  • create_proposal
  • detect_platform
  • generate_files
  • get_bazaar_listing_kit
  • get_citation_report
  • get_customer_files
  • get_pricing_tiers
  • recommend_tool_names
  • refine_quote
  • request_invoice
  • request_quote
  • run_site_audit
  • scan_site
  • start_agent_ready_setup
  • start_checkout
  • submit_lead
  • summarize_scan_for_humans
  • tier_selector
  • validate_x402_endpoint
  • verify_credentials
  • verify_deployment

Full input/output schemas come from tools/list — always call it rather than relying on this page.

Free vs paid responses

Scanning, quoting, and checkout are free to call. Delivery tools accept an optional bundle_key:

  • Without a key — you get the free starter files: robots.txt + llms.txt (also downloadable at /tools/llms-txt and /tools/robots-for-ai).
  • With a valid key — you get the customer's full paid deliverables.

A bundle_key is issued automatically when payment clears — on either rail — and is shown at /thank-you. Responses larger than 8KB are returned chunked.

Consent and trust

Sales tools accept a user_consent_scope (one_time_quote, comparison_shopping, ongoing_engagement) and only take actions the end user has authorized — a comparison-shopping agent can compare and quote but never gets committed past that scope. We never ask for buyer details the user has not consented to share.

Verify us before sharing data: credentials are published at /.well-known/attestations.json.

Machine surfaces