vendo.run
agent readiness score · scanned Aug 18, 2026 · 6s · Developer Tools
#82 of 979 · #23 in category
Vendo is an open-source customization layer that allows users to build their own features and micro-apps on top of existing software products, enabling personalized automation and views within the product's brand and guardrails.
Discovery 12.5/20
Access 28.8/30
Usability 21.8/40
Payments 10/10
Top fixes
- +5.6
OpenAPI spec discoverable
Publish your OpenAPI spec at /openapi.json and link it from docs — it's the single highest-leverage artifact for agent integration.
- +5
Brand search discoverability
Your domain doesn't surface when agents search "Vendo". Strengthen brand pages, structured data, and third-party citations (docs portals, GitHub, directories).
- +3.3
OAuth authorization server metadata
Metadata at https://console.vendo.run/.well-known/oauth-authorization-server lacks authorization_endpoint, code_challenge_methods_supported including S256. Serve complete RFC 8414 metadata with PKCE (S256) so agents can self-onboard.
- +2.8
MCP server discovery
Publish /.well-known/mcp/server-card.json describing your MCP endpoint so agents can autodiscover it. Evidence found: docs page (https://docs.vendo.run/).
- +2.5
Developer resource discoverability
Create a crawlable /docs or developers.vendo.run hub and link it from your homepage footer so search-grounded agents find your official API docs.
- +2.2
npm SDK
Publish an official npm SDK (suggest @vendo/sdk) with your domain in package.json homepage so agents can verify it's official.
1.Can an agent discover and trust you?
4/8
1.Can an agent discover and trust you?
Whether agents can crawl you, find you in the registries and searches they check, and trust what they find.
✓Sitemap present & fresh4/4
Sitemap at https://vendo.run/sitemap.xml: 12 entries, freshest <lastmod> 2026-08-15 (3 days ago)
Resolved the sitemap from robots.txt or /sitemap.xml, validated XML, and checked lastmod freshness
spec ↗✗Brand search discoverability0/4
Neither search ("Vendo", "Vendo developer tools") cited vendo.run. Cited instead: https://docs.vendodata.com/reports, https://docs.vendodata.com/sources/google-search-console/overview, https://docs.vendodata.com/agent/getting-started, https://docs.vendodata.com/agent/querying-data, https://docs.vendodata.com/data-dictionary
fix → Your domain doesn't surface when agents search "Vendo". Strengthen brand pages, structured data, and third-party citations (docs portals, GitHub, directories).
Ran clean brand-name web searches and checked whether your domain is cited in the results
—MCP registry listingsna
No MCP server detected for this product
Queried the official MCP registry, Smithery, Glama, and PulseMCP for servers matching your domain
spec ↗
2.Do you welcome agents?
14/16
2.Do you welcome agents?
Whether your robots policy, bot protection, and agent guidance actively admit AI agents instead of blocking them.
✓robots.txt present & parseable2/2
/robots.txt parses: 1 User-agent group(s), 1 Sitemap line(s)
Fetched /robots.txt and validated it parses as a robots policy
spec ↗✓AI crawler policy5/5
All 12 AI crawler user-agents (GPTBot, ClaudeBot, PerplexityBot, …) are allowed at / by robots.txt
Evaluated robots.txt groups for the major AI agent user-agents (GPTBot, ClaudeBot, PerplexityBot, …)
✗Content Signals directives0/2
No Content-Signal lines in robots.txt
fix → Declare Content Signals in robots.txt (e.g. `Content-Signal: search=yes, ai-train=no`) to express AI usage preferences machine-readably.
Looked for Content-Signal lines in robots.txt
spec ↗✓Agent user-agent parity4/4
All three UAs get HTTP 200; bot bodies are ClaudeBot 100%, GPTBot 100% of the browser response (114078 bytes)
Compared responses served to browser and AI-agent user-agents (informational while in beta)
✓agents.md3/3
Found https://vendo.run/agents.md: 26681 chars of markdown with 6 heading(s)
Fetched /agents.md and checked for substantive agent guidance
spec ↗
3.Does an agent understand who you are and what you do?
16/18
3.Does an agent understand who you are and what you do?
Whether your pages carry machine-readable identity: structured data, llms.txt, clear copy an agent can quote.
✓Homepage states what you are3/3
Homepage clarity rated 5/5 — an agent can confidently say what this company does (model's one-sentence read: "Vendo is an open-source customization layer that allows users to build their own features and micro-apps on top of existing software products, enabling personalized automation and views within the product's brand and guardrails.")
An LLM read your homepage as an agent would and rated how confidently it could say what you do
✓OpenGraph / social metadata2/2
Homepage has og:title, og:description, and og:image (twitter:card="summary_large_image" present)
Parsed homepage og:title / og:description / og:image and twitter:card meta tags
spec ↗✓llms.txt4/4
/llms.txt is valid llmstxt.org shape: H1 "Vendo", 3 markdown link(s)
Fetched /llms.txt and validated it against the llmstxt.org shape (H1, summary, curated links)
spec ↗✗llms-full.txt0/2
GET /llms-full.txt returned HTTP 404
fix → Add /llms-full.txt with expanded inline docs content so agents can load everything in one fetch.
Fetched /llms-full.txt and checked for substantial inline markdown content
spec ↗✓JSON-LD structured data4/4
6 JSON-LD block(s) on homepage and pricing page (types: Organization, SoftwareApplication, WebSite); Organization block is well-formed
Extracted and validated application/ld+json blocks on the homepage and pricing page
spec ↗✓Markdown content negotiation3/3
https://docs.vendo.run/ returns markdown for `Accept: text/markdown` (content-type text/markdown)
Requested key pages with Accept: text/markdown and probed .md twin URLs
4.Can an agent integrate with you?
watch →7.5/21
4.Can an agent integrate with you?
Whether the artifacts an agent needs to build on you — docs, API specs, SDKs, MCP servers — exist and are findable.
◐Developer resource discoverability1/3
Search "Vendo API documentation" cited no vendo.run URL — only third-party content describes your API: https://docs.vendodata.com/sources/tracking-sdk/api-reference, https://docs.vendodata.com/, https://docs.vendoservices.com/reference, https://docs.vendoservices.com/reference/payment-gateway, https://docs.vendodata.com/mcp
fix → Create a crawlable /docs or developers.vendo.run hub and link it from your homepage footer so search-grounded agents find your official API docs.
Searched for your brand with developer-keyword suffixes and checked which official resources are cited
✗OpenAPI spec discoverable0/5
No OpenAPI spec found: checked docs-page links and /openapi.json, /openapi.yaml, /swagger.json, /api/openapi.json, /docs/openapi.json, and api-subdomain locations
fix → Publish your OpenAPI spec at /openapi.json and link it from docs — it's the single highest-leverage artifact for agent integration.
Probed standard OpenAPI locations and docs links for a fetchable, parseable spec
spec ↗✓Docs discoverable4/4
Docs found at https://docs.vendo.run/ (via homepage link, 3636 chars of readable text)
Followed homepage nav/footer links and probed /docs, /developers, docs.{domain}
◐MCP server discovery2.5/5
MCP evidence found only as a mention in docs page (https://docs.vendo.run/): "MCP server" — no well-known server card
fix → Publish /.well-known/mcp/server-card.json describing your MCP endpoint so agents can autodiscover it. Evidence found: docs page (https://docs.vendo.run/).
Probed /.well-known/mcp/server-card.json, mcp.json, and docs mentions for an MCP endpoint
spec ↗✗npm SDK0/2
No official npm SDK found: probed 6 candidate(s) (@vendo/sdk, @vendo/vendo, vendo, vendo-sdk, vendo-api, vendo-js)
fix → Publish an official npm SDK (suggest @vendo/sdk) with your domain in package.json homepage so agents can verify it's official.
Searched the npm registry for an official, domain-verified SDK package
✗PyPI SDK0/2
No official PyPI SDK found: probed 4 candidate(s) (vendo, vendo-sdk, vendoapi, vendo-python)
fix → Publish an official Python SDK (suggest "vendo") with your domain in the project URLs so agents can verify it's official.
Searched PyPI for an official, domain-verified SDK package
5.Is your integration well-built?
watch →4.1/5
5.Is your integration well-built?
Whether your specs, docs, and tools are complete and descriptive enough for an agent to use them without guessing.
—OpenAPI validity & qualityna
No OpenAPI spec found — nothing to lint
Linted the spec: descriptions, operationIds, securitySchemes, servers
◐Docs quality2.1/3
Docs at https://docs.vendo.run/ scored clarity 4/5, completeness 3/5, runnable examples 3/5, agent-friendliness 4/5 (mean 3.5/5)
fix → Docs scored 3/5 on completeness. The documentation provides a high-level overview of the setup process but lacks detailed, step-by-step instructions for each of the three integration directions (Full-Stack Agent, Existing Agent, Outside Agents) after the initial `npx vendo init`.
An LLM rated your docs for clarity, completeness, runnable examples, and agent-friendliness
✓Quickstart / getting started2/2
Quickstart found: https://docs.vendo.run/ (linked from https://docs.vendo.run/) returns 200 with a code block
Looked for a quickstart/getting-started guide containing code blocks
—MCP tool qualityna
No MCP endpoint known — tool lint requires a tools/list
Linted listed tools for descriptions, typed input schemas, and naming
6.Can an agent use you reliably in production?
watch →2/4
6.Can an agent use you reliably in production?
Response hygiene, TLS and redirect discipline, and security contact channels agents depend on at runtime.
◐TLS & redirect hygiene1/2
http://vendo.run/ serves HTTP 200 without redirecting to https
fix → 301-redirect all http requests to https in one hop.
Checked http→https redirect behavior, chain length, and TLS health
✓Response speed & weight1/1
Homepage TTFB 44ms, payload 111KB, Content-Encoding: br
Measured homepage TTFB, payload size, and compression
✗security.txt0/1
https://vendo.run/.well-known/security.txt returned HTTP 404
fix → Publish RFC 9116 /.well-known/security.txt with a Contact and a future Expires.
Fetched /.well-known/security.txt and validated Contact + Expires
spec ↗
7.Can an agent authenticate to you?
watch →4/7
7.Can an agent authenticate to you?
Whether agents can discover your auth model machine-readably (OAuth metadata) and follow documented steps to credentials.
✗OAuth authorization server metadata0/3
OAuth metadata at https://console.vendo.run/.well-known/oauth-authorization-server (derived via protected-resource metadata at https://vendo.run/.well-known/oauth-protected-resource) is missing/invalid: authorization_endpoint, code_challenge_methods_supported including S256
fix → Metadata at https://console.vendo.run/.well-known/oauth-authorization-server lacks authorization_endpoint, code_challenge_methods_supported including S256. Serve complete RFC 8414 metadata with PKCE (S256) so agents can self-onboard.
Fetched /.well-known/oauth-authorization-server (and openid-configuration fallback)
spec ↗✓OAuth protected resource metadata2/2
Valid RFC 9728 metadata at https://vendo.run/.well-known/oauth-protected-resource: resource https://console.vendo.run, 1 authorization server(s) (https://console.vendo.run)
Fetched /.well-known/oauth-protected-resource
spec ↗✓Auth documentation2/2
Auth documentation found at https://vendo.run/auth.md (5034 chars, with code examples)
Looked for /auth.md or an authentication docs page with code examples
8.Can an agent transact with you?
watch →10/15
8.Can an agent transact with you?
Whether pricing is discoverable and machine-readable, and whether you support agent payment protocols.
✓Pricing discoverable5/5
Pricing page found at https://vendo.run/pricing (via homepage link) with legible price signals ("$0foreverTry everything, solo.").
Followed nav/footer links and probed /pricing for a page with legible price signals
✓Machine-readable pricing5/5
LLM extracted 3 numerically-priced plan(s) from https://vendo.run/pricing at confidence 1.00: Free $ 0/forever; Pro $ 49/month; Teams $ 499/month; Enterprise (contact sales).
Looked for Offer JSON-LD, then had an LLM attempt structured extraction of your plans
spec ↗✗x402 payment support0/2
/.well-known/x402 returned HTTP 404. No x402 support detected (bonus check — absence costs nothing).
fix → Support x402: serve payment requirements at /.well-known/x402, or answer unauthenticated API calls with HTTP 402 plus an x402 payment-requirements payload (x402Version, accepts[]).
Probed /.well-known/x402 and API endpoints for HTTP 402 payment-required envelopes
spec ↗✗AP2 readiness0/1
No AP2 hints found — scanned llms.txt, agents.md, docs page (https://docs.vendo.run/); /.well-known/ap2 returned HTTP 404.
fix → Adopt AP2 to accept delegated agent payments — see https://ap2-protocol.org.
Scanned fetched artifacts and well-known paths for AP2 hints
spec ↗✗Agentic Commerce Protocol0/1
No Agentic Commerce Protocol hints found — scanned llms.txt, agents.md, docs page (https://docs.vendo.run/); /.well-known/acp returned HTTP 404.
fix → Adopt the Agentic Commerce Protocol so agent checkouts can complete against your store — see https://developers.openai.com/commerce.
Scanned docs and specs for agentic checkout endpoints
spec ↗✗Other agent payment protocols0/1
No UCP/MPP hints found — scanned llms.txt, agents.md, docs page (https://docs.vendo.run/).
fix → Track emerging agent payment protocols (UCP, MPP) and adopt the ones your buyers' agents use.
Scanned fetched artifacts for UCP/MPP protocol hints
9.Can a user act through an agent?
—
9.Can a user act through an agent?
Whether an end user's agent can operate on their behalf: working MCP tools, published skills, agent configs.
—Agent skill publishedna
Requires the analysis phase — not yet evaluated
Checked /skill.md, /.well-known/skills/, and skills.sh for published agent skills
—MCP handshake & tools listna
No MCP endpoint known — nothing to handshake with
Performed a streamable-HTTP initialize + tools/list against the MCP endpoint
spec ↗—Agent configs in public repona
Requires the analysis phase — not yet evaluated
Checked your public GitHub org's main repos for AGENTS.md / .claude / .cursor configs
10.Can an agent operate your website directly?
7/9
10.Can an agent operate your website directly?
Whether the site itself is legible to non-rendering and browser agents: semantic HTML, no JS walls, accessibility.
✗NLWeb endpoint0/1
No NLWeb endpoint detected: /.well-known/nlweb.json returned HTTP 404 (text/html); GET /ask?query=hello returned HTTP 404 (text/html)
fix → Consider exposing an NLWeb /ask endpoint (and /.well-known/nlweb.json) for conversational access to your content.
Probed /.well-known/nlweb.json and the /ask endpoint
spec ↗✓Semantic HTML structure3/3
5/6 semantic signals present on the homepage (missing: text-to-markup ratio ≥ 0.10)
Scored landmark elements, heading hierarchy, and text-to-markup ratio on the homepage
✓Content readable without JavaScript2/2
Homepage raw HTML contains 4845 chars of visible text without JavaScript
Measured visible text in the raw, unrendered homepage HTML
✓Accessibility basics2/2
Homepage accessibility: 5/5 checks passed
Static checks: lang attribute, title, alt coverage, labeled inputs, landmarks
✗WebMCP0/1
No WebMCP evidence on homepage: no application/webmcp script and no navigator.modelContext reference
fix → Consider WebMCP to expose page actions as tools to browser agents.
Looked for WebMCP script declarations on the homepage
spec ↗