{
  "name": "TokRepo MCP Tool Catalog",
  "version": "2.16.1",
  "server": "io.github.henu-wang/tokrepo-mcp-server",
  "install": "npx -y tokrepo-mcp-server",
  "hosted_endpoint": "https://tokrepo.com/mcp",
  "hosted_transport": "streamable_http_json_rpc",
  "ecosystem_distribution": "https://tokrepo.com/agent-ecosystem.json",
  "task_economy_contract": "https://tokrepo.com/agent-task-economy.json",
  "agent_marketplace_listing": "https://tokrepo.com/agent-ecosystem.json#agent_marketplace_listing",
  "distribution_matrix": "https://tokrepo.com/agent-distribution-matrix.json",
  "trust_manifest": "https://tokrepo.com/.well-known/tokrepo-trust.json",
  "default_policy_pack": "https://tokrepo.com/policy-packs/default-agent-policy.json",
  "conversion_contract": {
    "funnel_metric": "mcp_search_to_install_plan",
    "primary_path": [
      "tokrepo_find_for_task",
      "tokrepo_install_plan",
      "tokrepo_verify",
      "tokrepo_codex_install"
    ],
    "required_next_tool": {
      "tokrepo_find_for_task": "tokrepo_install_plan",
      "tokrepo_resolve_capability": "tokrepo_install_plan",
      "tokrepo_search": "tokrepo_install_plan",
      "tokrepo_detail": "tokrepo_install_plan"
    },
    "agent_rule": "After a useful candidate is selected, call tokrepo_install_plan before recommending install, activation, or local writes."
  },
  "supply_conversion_contract": {
    "funnel_metric": "harvest_plan_to_harvest_publish",
    "primary_path": [
      "tokrepo_harvest",
      "tokrepo_handoff_plan",
      "tokrepo_push"
    ],
    "required_next_tool": {
      "tokrepo_harvest": "tokrepo_push_after_quality_gate_and_human_confirmation",
      "tokrepo_handoff_plan": "tokrepo_push_after_quality_gate_and_human_confirmation"
    },
    "agent_rule": "After reusable local work is harvested, inspect quality_gate, package_manifest, SBOM, provenance, and explicit file list. If ready_to_push=true or quality_gate passes, ask for human confirmation, then call tokrepo_push with only reviewed files and default private visibility. If the gate fails or human confirmation is missing, keep the package as a private draft."
  },
  "tools": [
    {
      "name": "tokrepo_session_init",
      "description": "Call FIRST at session start (once). Returns ≤500 tokens of capability inventory + project memory + recent handoffs + policy pack hash. Authoritative session bootstrap.",
      "read_only": true,
      "idempotent": true,
      "first_call_for": [
        "session bootstrap",
        "capability inventory",
        "project memory load",
        "policy pack hash"
      ]
    },
    {
      "name": "tokrepo_discover",
      "description": "Planning-time capability discovery for agents. Call this before inventing one-off tools.",
      "read_only": true,
      "idempotent": true,
      "first_call_for": [
        "skill discovery",
        "MCP config discovery",
        "prompt discovery",
        "workflow discovery",
        "agent capability gaps"
      ]
    },
    {
      "name": "tokrepo_find_for_task",
      "description": "Find a TokRepo asset for a concrete task. This is the first atomic action in the find/install/harvest loop.",
      "read_only": true,
      "idempotent": true,
      "next_best_action": "When a candidate is useful, call tokrepo_install_plan for that asset before recommending installation.",
      "first_call_for": [
        "concrete task asset discovery",
        "find install harvest lifecycle"
      ]
    },
    {
      "name": "tokrepo_resolve_capability",
      "description": "Resolve a planning-time capability gap into a selected asset with verification evidence, install_plan, lifecycle_contract, next_mcp_calls, and CLI fallbacks.",
      "read_only": true,
      "idempotent": true,
      "next_best_action": "For the selected capability result, call tokrepo_install_plan before recommending installation or local writes.",
      "first_call_for": [
        "planning-time capability gaps",
        "missing skill detection",
        "agent default action before local build"
      ]
    },
    {
      "name": "tokrepo_search",
      "description": "Search reusable AI assets by query, kind, target, and install policy.",
      "read_only": true,
      "idempotent": true,
      "next_best_action": "For the selected result, call tokrepo_install_plan instead of stopping at search results."
    },
    {
      "name": "tokrepo_detail",
      "description": "Read asset details, metadata, files, tags, and install instructions.",
      "read_only": true,
      "idempotent": true,
      "next_best_action": "If the asset fits the task, call tokrepo_install_plan and tokrepo_verify before any local write."
    },
    {
      "name": "tokrepo_edges",
      "description": "Read asset relationship edges such as requires, extends, and co-used assets.",
      "read_only": true,
      "idempotent": true
    },
    {
      "name": "tokrepo_install_plan",
      "description": "Return a typed install plan with preconditions, risk, rollback, post_verify, evidence_bundle, SBOM-lite, and signature_evidence before any write.",
      "read_only": true,
      "idempotent": true,
      "next_best_action": "Compare with tokrepo_verify, then use tokrepo_codex_install dry_run before asking for explicit apply confirmation."
    },
    {
      "name": "tokrepo_verify",
      "description": "Verify asset trust, content hash, install plan hash, permission envelope, policy decision, trust_score_v2, evidence_bundle, provenance_v2, SBOM-lite, signature_evidence, blockers, and warnings before activation.",
      "read_only": true,
      "idempotent": true,
      "first_call_for": [
        "trust verification",
        "permission inspection",
        "pre-install safety",
        "agent acceptance checks"
      ]
    },
    {
      "name": "tokrepo_codex_install",
      "description": "Install or stage an asset for Codex; defaults to dry_run=true and requires explicit confirmation to write.",
      "read_only_by_default": true,
      "requires_confirmation_for_write": true
    },
    {
      "name": "tokrepo_installed",
      "description": "List locally installed TokRepo-managed assets, including project TokRepo.lock/.tokrepo/state.json lifecycle state when available.",
      "read_only": true,
      "idempotent": true
    },
    {
      "name": "tokrepo_update",
      "description": "Check or update installed TokRepo assets; defaults to dry_run=true.",
      "read_only_by_default": true,
      "requires_confirmation_for_write": true
    },
    {
      "name": "tokrepo_uninstall",
      "description": "Safely uninstall a TokRepo-managed asset; defaults to dry_run=true.",
      "read_only_by_default": true,
      "requires_confirmation_for_write": true
    },
    {
      "name": "tokrepo_rollback",
      "description": "Roll back a previous TokRepo install session; defaults to dry_run=true.",
      "read_only_by_default": true,
      "requires_confirmation_for_write": true
    },
    {
      "name": "tokrepo_handoff_plan",
      "description": "Inspect local reusable work after a task and return an explicit packaging plan with quality_gate, package_manifest, SBOM, provenance, and private-by-default push command. Read-only; never publishes automatically.",
      "read_only": true,
      "idempotent": true,
      "next_best_action": "If quality_gate passes and the file list is explicit, ask the user for confirmation before tokrepo_push; otherwise report the cleanup needed and keep the draft private.",
      "first_call_for": [
        "post-task handoff",
        "reusable local skill detection",
        "safe push planning",
        "agent supply feedback loop"
      ]
    },
    {
      "name": "tokrepo_harvest",
      "description": "Inspect local changed or explicit files after a task and return private-by-default reusable asset package drafts with metadata, usage examples, risk notes, compatibility, and quality gates. Read-only; never publishes automatically.",
      "read_only": true,
      "idempotent": true,
      "next_best_action": "If ready_to_push=true or quality_gate passes, ask the user for confirmation before tokrepo_push with explicit reviewed files and default private visibility; otherwise report the cleanup needed.",
      "first_call_for": [
        "post-task reusable output harvest",
        "agent supply feedback loop",
        "private package draft generation"
      ]
    },
    {
      "name": "tokrepo_push",
      "description": "Publish explicit reusable files to TokRepo after human confirmation. Never push secrets or implicit project files.",
      "requires_confirmation_for_write": true,
      "default_visibility": "private"
    }
  ],
  "funnel_events": [
    "init_agent",
    "agent_check",
    "capability_resolve",
    "agent_handoff",
    "handoff_plan",
    "harvest_plan",
    "mcp_discover",
    "mcp_search",
    "mcp_detail",
    "verify_asset",
    "audit_asset",
    "install_plan",
    "install_dry_run",
    "install_apply",
    "rollback_plan",
    "push"
  ]
}