{
  "schema_version": "2026-05-18.agent-distribution-matrix.v1",
  "name": "TokRepo Agent Distribution Matrix",
  "canonical_url": "https://tokrepo.com/agent-distribution-matrix.json",
  "updated_at": "2026-05-18",
  "principle": "Prioritize the places agents already inspect: MCP registries, npm metadata, GitHub metadata, project-memory templates, well-known manifests, llms/agents text, and tool marketplaces.",
  "status_legend": {
    "shipped": "Owned by TokRepo and available from tokrepo.com or this repository.",
    "published": "Published to an external package or source host controlled by TokRepo.",
    "listed": "Discoverable in an external registry.",
    "submission_ready": "Listing copy, install commands, manifests, and verification evidence are ready for external submission.",
    "external_auth_required": "Requires a human account, marketplace owner action, or third-party review outside this repository."
  },
  "required_phrases": [
    "tokrepo_discover",
    "tokrepo_verify",
    "tokrepo_install_plan",
    "tokrepo_handoff_plan",
    "npx -y tokrepo@latest init-agent --target all",
    "npx -y tokrepo-mcp-server",
    "https://tokrepo.com/.well-known/tokrepo.json",
    "https://tokrepo.com/agent-ecosystem.json"
  ],
  "channels": [
    {
      "id": "npm_cli",
      "name": "npm package: tokrepo",
      "status": "published",
      "agent_discovery_value": "Agents and humans searching npm for reusable agent skills, CLI workflows, llms.txt, MCP registry, or TokRepo can find the bootstrap CLI.",
      "machine_entry": "https://www.npmjs.com/package/tokrepo",
      "install": "npx -y tokrepo@latest init-agent --target all",
      "verification": "npm view tokrepo version description keywords repository --json",
      "required_metadata": ["description", "keywords", "repository", "bin"]
    },
    {
      "id": "npm_mcp",
      "name": "npm package: tokrepo-mcp-server",
      "status": "published",
      "agent_discovery_value": "MCP clients can install TokRepo through the package manager path most registries index.",
      "machine_entry": "https://www.npmjs.com/package/tokrepo-mcp-server",
      "install": "npx -y tokrepo-mcp-server",
      "verification": "npm view tokrepo-mcp-server version description keywords repository mcpName --json",
      "required_metadata": ["mcpName", "description", "keywords", "repository", "bin"]
    },
    {
      "id": "official_mcp_registry",
      "name": "Official MCP Registry",
      "status": "listed",
      "agent_discovery_value": "Agents and MCP clients that search registry.modelcontextprotocol.io can find TokRepo through the standard server.json metadata path.",
      "machine_entry": "https://registry.modelcontextprotocol.io/v0/servers?search=tokrepo",
      "install": "npx -y tokrepo-mcp-server",
      "verification": "curl -s 'https://registry.modelcontextprotocol.io/v0/servers?search=tokrepo' | jq",
      "required_metadata": ["mcp-server/server.json", "mcpName"]
    },
    {
      "id": "hosted_mcp",
      "name": "Hosted read-only MCP endpoint",
      "status": "shipped",
      "agent_discovery_value": "Remote agents can inspect tools/list and call read-only discovery without installing local packages.",
      "machine_entry": "https://tokrepo.com/mcp",
      "verification": "WEB_BASE=https://tokrepo.com API_BASE=https://api.tokrepo.com node scripts/production-agent-discovery-check.mjs"
    },
    {
      "id": "well_known_manifests",
      "name": ".well-known agent and trust manifests",
      "status": "shipped",
      "agent_discovery_value": "Crawler-style agents can discover TokRepo from stable machine-readable URLs without scraping UI pages.",
      "machine_entry": "https://tokrepo.com/.well-known/tokrepo.json",
      "verification": "curl -s https://tokrepo.com/.well-known/tokrepo.json | jq '.mcp_tools.discover,.endpoints.agent_ecosystem'"
    },
    {
      "id": "llms_agents_text",
      "name": "llms.txt, llms-full.txt, agents.txt",
      "status": "shipped",
      "agent_discovery_value": "LLM crawlers and documentation-aware agents get the same discovery/install/handoff contract in text form.",
      "machine_entry": "https://tokrepo.com/agents.txt",
      "verification": "curl -s https://tokrepo.com/agents.txt | rg 'tokrepo_discover|tokrepo_install_plan|agent-handoff'"
    },
    {
      "id": "project_memory_templates",
      "name": "Agent-native starter templates",
      "status": "shipped",
      "agent_discovery_value": "Future sessions inside a repository learn TokRepo from the files the active agent already reads.",
      "machine_entry": "https://tokrepo.com/agent-instructions/tokrepo.md",
      "install": "npx -y tokrepo@latest init-agent --target all",
      "verification": "node scripts/run_agent_onboarding_compliance.mjs --json"
    },
    {
      "id": "vscode_extension",
      "name": "VS Code extension package",
      "status": "submission_ready",
      "agent_discovery_value": "Cursor, Cline, Copilot, Windsurf, Roo, and VS Code users can bootstrap MCP plus project rules from a familiar extension surface.",
      "machine_entry": "vscode-extension/package.json",
      "verification": "node -e \"const j=require('./vscode-extension/package.json'); console.log(j.name, j.description)\"",
      "next_action": "Package and submit to the VS Code Marketplace with the existing package metadata."
    },
    {
      "id": "gemini_extension",
      "name": "Gemini CLI extension",
      "status": "submission_ready",
      "agent_discovery_value": "Gemini CLI users can install a bundled context file plus MCP server config.",
      "machine_entry": "skills/gemini-extension/tokrepo/gemini-extension.json",
      "verification": "node -e \"const j=require('./skills/gemini-extension/tokrepo/gemini-extension.json'); console.log(j.name || j.id)\"",
      "next_action": "Submit or publish the extension through the Gemini CLI extension distribution path."
    },
    {
      "id": "cline_marketplace",
      "name": "Cline MCP Marketplace",
      "status": "external_auth_required",
      "agent_discovery_value": "Cline users and enterprises can approve TokRepo as a marketplace MCP server or preconfigured remote MCP.",
      "machine_entry": "https://tokrepo.com/.well-known/mcp/server.json",
      "verification": "Use the Cline marketplace submission/review flow, then search Cline MCP Marketplace for TokRepo.",
      "next_action": "Submit with install command npx -y tokrepo-mcp-server and evidence links from agent-ecosystem.json."
    },
    {
      "id": "smithery_glama_mcpso",
      "name": "Smithery, Glama, MCP.so and community MCP directories",
      "status": "external_auth_required",
      "agent_discovery_value": "Agents that search community MCP directories can find TokRepo before knowing its domain.",
      "machine_entry": "https://tokrepo.com/agent-ecosystem.json",
      "verification": "Search each directory for TokRepo and confirm the listing links to tokrepo-mcp-server plus hosted MCP.",
      "next_action": "Use the canonical listing copy from agent-ecosystem.json; complete submissions requiring account ownership."
    },
    {
      "id": "awesome_lists",
      "name": "awesome-* and agent-tool list PRs",
      "status": "submission_ready",
      "agent_discovery_value": "Agents often search GitHub lists and README corpora during cold-start tool discovery.",
      "machine_entry": "github-submissions/",
      "verification": "Review PR drafts under github-submissions/ and confirm merged URLs after submission.",
      "next_action": "Submit/update PRs using github-submissions/tokrepo-cross-agent-quickstart.md and agent-infrastructure-registry-wave.md."
    }
  ],
  "verification": {
    "local": "node scripts/verify_agent_distribution_matrix.mjs",
    "production": "WEB_BASE=https://tokrepo.com API_BASE=https://api.tokrepo.com node scripts/production-agent-discovery-check.mjs",
    "minimum_required_statuses": ["shipped", "published", "listed", "submission_ready", "external_auth_required"]
  }
}