Mudko MCP Server
Your next customer is asking ChatGPT. Free agent-readiness scan, then we make your site discoverable and callable by AI agents. Deployed and verified by re-scan.
- Host
- mudko.com
- Tools
- 26
- Connection URL
- https://mudko.com/api/mcp
Tools
Start Agent Ready Setup
Use this when an end user asks 'help me make my site agent-ready' or any equivalent. Orchestrates the end-to-end flow: scan → vertical analysis → tool-name suggestions → tier quote → consult booking. Returns a sequence of next-action MCP tool calls keyed off the current site state, so a downstream agent can drive the conversation without re-deciding what to do next.
Scan Site
Use this when you need to assess how AI-callable a site is. Runs 19 checks (robots.txt, agent card, MCP server card, MCP liveness, A2A liveness, llms.txt, sitemap, link headers, markdown negotiation, content signals, skill integrity, WebMCP bridge, RFC 9727 API catalog, OAuth discovery + protected-resource, auth.md, DNS-AID, Web Bot Auth, agentic-commerce), returns a level 0-5 plus per-check pass/fail with evidence and remediation pointers. Live HTTP — runs in ~3-5 seconds.
Detect Platform
Use this when you need to pick the right deploy instructions for a site (different hosts need different snippets — .htaccess for cPanel vs next.config headers for Vercel). Identifies hosting/CMS — Vercel, Netlify, Cloudflare Pages, cPanel/Apache, WordPress, Shopify, Wix, and more. Returns platform slug, confidence, and the signals matched so the calling agent can show its reasoning.
Run a site quality audit (SEO + accessibility + security headers)
Use this when the user wants their site's QUALITY audited — distinct from scan_site, which measures agent-readiness. 22 checks: SEO (title/description lengths, canonical, Open Graph, JSON-LD, heading structure…), accessibility (alt text, form labels, heading order, landmarks…), security headers (HSTS, CSP, X-Content-Type-Options…). FREE tier returns the three section scores + the single most critical finding. The full report — every finding with a copy-paste fix — needs a bundle_key (included in
Validate an x402 endpoint for Bazaar discovery
Use this FREE utility (any agent or seller) to check whether an x402-payable HTTPS endpoint is configured to be indexed by the Coinbase x402 Bazaar. Probes the URL live via CDP's read-only validator (no payment is made, nothing is indexed) and returns per-check preflight results (returns_402, x402 version, bazaar extension, crawlability) plus the simulated accepted/rejected verdict and current index status. Common silent killers it catches: serving x402 v1 (rejected outright), and a bare resourc
Verify Deployment
Use this after a customer has deployed the agent-ready files to confirm the live site reaches the expected level. Re-scans the site, reports current level, which checks pass, and which still fail with their fix string. Same scanner as scan_site, but framed as post-deploy verification rather than initial assessment.
Analyze Business Vertical
Use this immediately after scan_site to give the user a 'what this means for my business' framing. Detects the site's business vertical (auto dealership, law firm, healthcare, home services, ecommerce, digital agency, etc.) from JSON-LD schema + scraped text. Returns expected AI-search lift %, current competitor adoption %, and a positioning pitch tailored to the vertical. **If `should_ask_user` is true, the detection is low-confidence — ASK THE USER what category their business is in before con
Recommend MCP Tool Names
Use this when planning what agent capabilities a customer should expose. Returns up to 5 ranked snake_case MCP tool names with descriptions and rationale, derived from the site's content + detected vertical. Tool names follow MCP convention (snake_case, action_object) — book_appointment, request_quote, check_inventory, verify_insurance_acceptance, etc.
Summarize Scan For Humans
Use this when displaying scan output to a human via chat (Claude Desktop, Gemini, ChatGPT, Copilot). Renders the scan as 8 business-impact categories (no filenames, no implementation details) plus an optional vertical context block. Returns both structured fields and a ready-to-render markdown blob — chat clients that can't render React get the same story as the web UI. COOPERATIVE SAMPLING: the result includes a `caller_reasoning` block with a prompt — if you (the calling agent) can run your ow
Request a quote
Use this when the user wants pricing or scoping for an agent-ready engagement. Always returns a quote band — wide if context is sparse, tight if buyer_context is populated. Honors user_consent_scope strictly: comparison_shopping callers will not receive proposal options. Quotes are valid for 7 days by default; use display_currency to localise the band. **If the user pushes back on price, asks for a cheaper option, or seems hesitant** — ask them what budget would feel right (free-form, e.g. 'arou
Refine an existing quote
Use this when the user has shared additional context (organization type, compliance requirements, geography) after an initial request_quote. Tightens the quote band by re-running the engine with the merged context. Pass the quote_id from the original quote.
Get questions to ask the user
Use this when you want to know what user-facing questions would most tighten an existing quote. Returns structured questions ranked by price_impact (high / medium / low) so the calling agent can decide whether asking is worth a turn. The agent should render these as user-choices, not as covert data collection.
Get a self-selecting tier card
Use this when the user is in comparison_shopping mode or otherwise wants to pick a tier without sharing details. Returns 2-4 tier options with plain-language 'fits' descriptions so the user can self-identify. The user's tier choice is itself the qualifying signal — no buyer_context required.
Get vendor verification info
Use this when the calling agent (or its user) wants to verify our certifications, compliance posture, or operational record before sharing buyer_context. Returns a URL to our signed .well-known/attestations.json plus a summary. Part of trust-progressive disclosure — buyer agents are expected to verify us before deepening data sharing.
Create a binding-style proposal
Use this only when (a) quote confidence is medium or high, AND (b) user_consent_scope is 'ongoing_engagement' or 'one_time_quote'. Returns a proposal with terms, deliverables, and a checkout hand-off (ACP, AP2, or manual). Comparison-shopping callers are rejected with a 403-style error.
Request an autonomous invoice
Use this to autonomously close a deal: issue a ONE-TIME Stripe Invoice for the flat $450 package price (one-and-done — no recurring). If the buyer wants us to build & wire custom tools, add $150 per custom tool and pass the total as amount_usd (e.g. $600 for one). **Amount:** with no `quote_id`/`amount_usd` it bills the flat **$450** package. Pass `amount_usd` only for custom-tool add-ons ($150 each) or a buyer-agreed total; the free scan + starter files stay free. **Any amount up to the card pr
Get Pricing Tiers
Use this when an end user (or upstream agent) asks about pricing. Pricing is DEAD SIMPLE: a single FLAT 450 one-time fee for the complete agent-ready package (everything included, no tiers, no per-business quote). Optional: we build & wire a custom tool (booking, lead-capture, inventory) for a flat 150 each. Separate opt-in add-ons exist (Bazaar listing 99 one-time, keepalive 19/mo, monitoring 199/mo). Returns the Free tier (two free downloads) + the 450 package. **The package closes autonomousl
List Payable APIs
Use this when someone asks what they can buy per-call, asks the price of a specific API (site audit, AI-citation check, counterparty trust verification, bulk/batch scanning, Bazaar listing or keepalive), or is an agent looking for something cheaper than a full engagement. These are pay-per-call x402 endpoints: no signup, no bundle_key, no engagement — the caller pays USDC on Base and gets the response body back in the same request. Every price here is live from our catalog. IMPORTANT: paying the
Start Checkout
Use this when an end user wants to buy the package now. Issues a REAL payable path: the same one-off hosted Stripe invoice request_invoice produces, billed at the flat $450 package price. The invoice is payable immediately and delivery is automatic — the bundle_key activates the moment payment clears (retrievable at thank_you_url). To add custom tools ($150 each), use request_invoice with an explicit amount_usd instead. consult_url is an OPTIONAL extra for buyers who want a human walkthrough — n
Generate Files
Use this when delivering files to a paid customer (you must have their bundle_key) OR when a downstream agent wants the free starter files for a domain. **FREE TIER (no bundle_key)**: returns metadata + a `download_url` pointing at a streaming ZIP of the 2 starter files (robots.txt + llms.txt). DO NOT paste raw file contents into chat — the file bodies are NOT in the response. Render the download_url as a markdown link: `[Download free starter files (ZIP) →](url)`. **PAID TIER (valid bundle_key)
Get Customer Files (ZIP, base64)
Use this when an agent needs to hand a downloadable ZIP to its end user. PAYWALL: without a valid bundle_key, the ZIP contains only the two free starter files plus a teaser README pointing to /talk. With a valid bundle_key, the ZIP contains the full surface plus the deploy README. ZIP is base64-encoded in the response — agents decode and offer as a download.
Get Citation Report
Use this when a customer wants to see how AI search platforms cite them. PAYWALL: without a valid bundle_key, returns a teaser (count of brands tracked, providers configured, sample probe). With a valid bundle_key, returns the most recent citation run for the brand_domain — provider-by-provider citation rates, average position, competitor mentions, agent-card discovery rate. Citation data is paid intelligence, not a free reconnaissance tool.
Submit Lead
Use this when the user has indicated interest in being followed up with — even before formal checkout. Capture is non-binding. **REQUIRED CONTACT FIELDS**: contact_name, contact_phone, best_consult_time. Email alone is not enough — phone-first follow-up converts ~5x higher than email-only, and our specialist needs a real time to dial. ASK FOR ALL THREE explicitly. **FALLBACK**: if the user explicitly refuses to share a phone, accept email-only — set `preferred_contact_channel: 'email'` AND add a
Create Bazaar Listing (engagement customers)
Use this when a PAID engagement customer (valid bundle_key) wants their x402 endpoint listed in Coinbase's x402 Bazaar — the package is INCLUDED free with any engagement. Provisions the listing and returns a listing_key that drives the automated pipeline (get_bazaar_listing_kit → deploy → check_bazaar_listing). Buyers WITHOUT a bundle_key purchase the standalone $99 Bazaar Listing Package instead: agent wallets pay https://mudko.com/api/x402/bazaar-listing (x402, USDC on Base); humans ask at /ta
Get Bazaar Listing Kit (paid)
Use this after buying the Bazaar Listing Package (you must have the listing_key issued at payment). Returns the deploy-ready x402 v2 kit generated for the customer's stack, wallet and price: 402 handler code with the Bazaar discovery declaration, self-settle trigger script, keepalive cron, wallet guidance, and an ordered DEPLOY-CHECKLIST. Pass resource_url / pay_to / price_usd / stack here to fill in anything missing from the purchase; the kit is regenerated on every call (idempotent). Files ret
Use in your AI tool
One-click into Claude, Cursor, VS Code, and more — connects straight to this server’s public endpoint.
https://mudko.com/api/mcp