tokrepo-mcp-server 2.8.0 → 2.9.0

package/README.md

@@ -43,7 +43,7 @@ Once connected, your AI assistant can:
 - **Safe Codex install** — dry-run by default; risky assets must be staged or explicitly approved
 - **Lifecycle control** — list, update, uninstall, and roll back managed Codex installs
 - **Project memory** — pair with `tokrepo init-agent --target all` so future agents know to call TokRepo during planning
-- **Discovery surfaces** — official MCP `server.json`, `.well-known`, `llms.txt`, and npm metadata are kept machine-readable for agents and registries
+- **Discovery surfaces** — official MCP `server.json`, A2A agent card, portable agent manifest, tool catalog, `.well-known`, `agents.txt`, `llms.txt`, and npm metadata are kept machine-readable for agents and registries
 - **Funnel visibility** — anonymous aggregate events show whether agents actually discover, plan, install, hand off, and push reusable assets
 
 ## Available Tools
@@ -84,7 +84,7 @@ Run this once in a project:
 npx tokrepo init-agent --target all
 ```
 
-It writes managed instructions to `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, Cursor rules, and `.mcp.json`. The rule is simple: during planning, when the agent sees a capability gap, it should call `tokrepo_discover` before inventing a one-off local tool. After a task, agents can run `tokrepo agent-handoff --json` to suggest reusable files for user-confirmed private publishing.
+It writes managed instructions to `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, Cursor rules, GitHub Copilot instructions, Cline rules, Windsurf rules, Roo rules, OpenHands microagents, Aider conventions, and `.mcp.json`. The rule is simple: during planning, when the agent sees a capability gap, it should call `tokrepo_discover` before inventing a one-off local tool. After a task, agents can run `tokrepo agent-handoff --json` to suggest reusable files for user-confirmed private publishing.
 
 ## Machine-Readable Listing
 
@@ -92,6 +92,10 @@ Registries and agents can discover this server through:
 
 - MCP server manifest: [tokrepo.com/.well-known/mcp/server.json](https://tokrepo.com/.well-known/mcp/server.json)
 - TokRepo manifest: [tokrepo.com/.well-known/tokrepo.json](https://tokrepo.com/.well-known/tokrepo.json)
+- Portable agent manifest: [tokrepo.com/.well-known/agent.json](https://tokrepo.com/.well-known/agent.json)
+- A2A agent card: [tokrepo.com/.well-known/agent-card.json](https://tokrepo.com/.well-known/agent-card.json)
+- Tool catalog: [tokrepo.com/.well-known/tool-catalog.json](https://tokrepo.com/.well-known/tool-catalog.json)
+- Agent text entry: [tokrepo.com/agents.txt](https://tokrepo.com/agents.txt)
 - Agent instructions: [tokrepo.com/agent-instructions/tokrepo.md](https://tokrepo.com/agent-instructions/tokrepo.md)
 - LLM crawler entry: [tokrepo.com/llms.txt](https://tokrepo.com/llms.txt)
 

package/bin/server.js

@@ -20,7 +20,7 @@ const API_BASE = process.env.TOKREPO_API || 'https://api.tokrepo.com';
 const TOKREPO_URL = 'https://tokrepo.com';
 const TOKREPO_TOKEN = process.env.TOKREPO_TOKEN || '';
 const TOKREPO_CLI = process.env.TOKREPO_CLI || '';
-const SERVER_VERSION = '2.8.0';
+const SERVER_VERSION = '2.9.0';
 
 // ─── MCP Protocol (JSON-RPC over stdio) ───
 
@@ -47,7 +47,7 @@ const TOOLS = [
         target: {
           type: 'string',
           description: 'Optional agent/runtime target. Use "any" for generic discovery.',
-          enum: ['any', 'codex', 'claude_code', 'gemini_cli', 'cursor', 'windsurf', 'mcp_client'],
+          enum: ['any', 'codex', 'claude_code', 'gemini_cli', 'cursor', 'copilot', 'cline', 'windsurf', 'roo', 'openhands', 'aider', 'mcp_client'],
           default: 'any',
         },
         environment: {
@@ -92,7 +92,7 @@ const TOOLS = [
         target: {
           type: 'string',
           description: 'Optional agent target filter. Use "any" or omit it for generic discovery.',
-          enum: ['any', 'codex', 'claude_code', 'gemini_cli', 'cursor', 'windsurf', 'mcp_client'],
+          enum: ['any', 'codex', 'claude_code', 'gemini_cli', 'cursor', 'copilot', 'cline', 'windsurf', 'roo', 'openhands', 'aider', 'mcp_client'],
         },
         kind: {
           type: 'string',
@@ -444,7 +444,85 @@ const EXPOSED_TOOL_NAMES = new Set([
   'tokrepo_push',
 ]);
 
-const EXPOSED_TOOLS = TOOLS.filter((tool) => EXPOSED_TOOL_NAMES.has(tool.name));
+const TOOL_ANNOTATIONS = {
+  tokrepo_discover: {
+    title: 'Discover reusable AI assets before inventing a one-off tool',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+  },
+  tokrepo_search: {
+    title: 'Search reusable AI assets',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+  },
+  tokrepo_detail: {
+    title: 'Read asset details and metadata',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+  },
+  tokrepo_install_plan: {
+    title: 'Plan an install before any file write',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+  },
+  tokrepo_codex_install: {
+    title: 'Dry-run, stage, or install an asset for Codex',
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: true,
+  },
+  tokrepo_installed: {
+    title: 'List locally installed TokRepo assets',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+  },
+  tokrepo_update: {
+    title: 'Dry-run or update installed TokRepo assets',
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: true,
+  },
+  tokrepo_uninstall: {
+    title: 'Dry-run or uninstall a TokRepo-managed asset',
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: false,
+  },
+  tokrepo_rollback: {
+    title: 'Dry-run or roll back a TokRepo install session',
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: false,
+  },
+  tokrepo_push: {
+    title: 'Publish explicit reviewed files to TokRepo after confirmation',
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: true,
+  },
+};
+
+const EXPOSED_TOOLS = TOOLS
+  .filter((tool) => EXPOSED_TOOL_NAMES.has(tool.name))
+  .map((tool) => ({
+    ...tool,
+    annotations: TOOL_ANNOTATIONS[tool.name],
+  }));
 
 // ─── HTTP Helper ───
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokrepo-mcp-server",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "description": "Agent-native MCP server for TokRepo — search, plan, safely install, and push AI assets from MCP clients.",
   "mcpName": "io.github.henu-wang/tokrepo-mcp-server",
   "bin": {
@@ -24,6 +24,10 @@
     "cursor",
     "codex",
     "gemini",
+    "copilot",
+    "cline",
+    "windsurf",
+    "openhands",
     "skills",
     "prompts",
     "workflows",
@@ -33,6 +37,8 @@
     "claude-code",
     "openai-codex",
     "mcp-registry",
+    "agent-manifest",
+    "a2a-agent-card",
     "tool-discovery",
     "llms-txt"
   ],