← Back to all products

Agent Discoverability Kit

$39

Generators that make a product or site discoverable to AI agents: llms.txt, .well-known/ai-plugin.json, an MCP-registry server.json, and valid schema.org Product JSON-LD.

9 filesv1.0.0 (updated 2026-08-02)
MarkdownTypeScriptJSONLLM

File Structure 9 files

agent-discoverability-kit/ ├── LICENSE ├── README.md ├── examples/ │ └── generate.ts ├── package.json └── src/ ├── index.ts ├── jsonld.ts ├── llms.ts └── manifest.ts

Documentation Preview README excerpt

Agent Discoverability Kit

Make your product, store, or API discoverable and usable by AI agents. This kit

generates the machine-readable surfaces agents and LLM crawlers look for:

llms.txt, a .well-known/ai-plugin.json manifest, an MCP-registry server.json,

and valid Product JSON-LD — all from one small product/site config.

This is the discoverability layer that got a real store listed in the official MCP

registry and surfaced to LLM crawlers, packaged as reusable generators.

What agents look for (and this generates)

SurfaceFileWho consumes it
LLM site indexllms.txtChatGPT, Perplexity, Claude, Gemini crawlers
Plugin manifest.well-known/ai-plugin.jsonAgent frameworks / plugin hosts
MCP server recordserver.jsonOfficial MCP Registry + mirrors
Product structured dataProduct JSON-LDGoogle/Bing, AI shopping answers

Features

  • llmsTxt(site) — build a clean llms.txt from your site + product list.
  • aiPluginManifest(site) — the well-known plugin manifest.
  • serverJson(mcp) — a schema-valid MCP registry record for a remote server.
  • productJsonLd(product) — valid schema.org Product markup (brand, seller,

offer, availability, priceValidUntil) to embed in product pages.

Requirements

  • Node.js 18+ (pure standard library; no runtime dependencies)

Quick start


npm install    # only needed for the TypeScript toolchain / tests
npx tsx examples/generate.ts   # prints all four artifacts for a sample store

import { llmsTxt, productJsonLd } from './src/index.js';

const txt = llmsTxt({
  name: 'Acme Tools',
  baseUrl: 'https://acme.example',
  summary: 'Developer toolkits and templates.',
  mcpUrl: 'https://acme.example/mcp',
  products: [{ slug: 'widget', name: 'Widget Kit', price: 49, desc: 'A widget kit.' }],
});

File tree


src/
  llms.ts        # llmsTxt() generator
  manifest.ts    # aiPluginManifest() + serverJson()
  jsonld.ts      # productJsonLd() (schema.org Product)
  index.ts       # re-exports + shared types
examples/
  generate.ts    # prints all four artifacts for a sample store

*... continues with setup instructions, usage examples, and more.*

Code Sample .ts preview

src/index.ts /** Shared types for the discoverability generators. */ export interface ProductLite { slug: string; name: string; price: number; desc: string; } export interface SiteConfig { name: string; baseUrl: string; // no trailing slash summary: string; mcpUrl?: string; openapiUrl?: string; catalogUrl?: string; contactEmail?: string; products?: ProductLite[]; } export interface McpConfig { namespace: string; // e.g. "com.example/store" (reverse-DNS you can prove) description: string; // <= 100 chars for the registry version: string; mcpUrl: string; repositoryUrl?: string; websiteUrl?: string; } export interface ProductForLd { id: string; // stable SKU / product id name: string; description: string; price: number; currency?: string; url: string; // canonical product URL brand?: string; available?: boolean; } export * from './llms.js'; export * from './manifest.js'; export * from './jsonld.js';