← Back to all products
$39
Agent Discoverability Kit
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.
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)
| Surface | File | Who consumes it |
|---|---|---|
| LLM site index | llms.txt | ChatGPT, Perplexity, Claude, Gemini crawlers |
| Plugin manifest | .well-known/ai-plugin.json | Agent frameworks / plugin hosts |
| MCP server record | server.json | Official MCP Registry + mirrors |
| Product structured data | Product JSON-LD | Google/Bing, AI shopping answers |
Features
llmsTxt(site)— build a cleanllms.txtfrom 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.orgProductmarkup (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';