Tokrepo MCP Server

Agent-native MCP server for TokRepo: session bootstrap, capability discovery, search/detail, trust verification, install planning, Codex staging

Local serverstdio

What is the Tokrepo MCP server?

Most planning and project tracking work still happens through a UI a human drives. Tokrepo MCP server moves it into the conversation instead. Agent-native MCP server for TokRepo: session bootstrap, capability discovery, search/detail, trust verification, install planning, Codex staging, lifecycle inspection/update/uninstall/rollback, handoff/harvest planning, and human-confirmed.

The short version

You: "What video assets should I install?" AI: [calls tokrepo_resolve_capability] → Finds relevant skills, checks fit, trust, and policy, then asks before installing

  • Discover during planning — — turn a task or capability gap into structured candidate skills, prompts, MCP configs, scripts, and workflows
  • Resolve capability gaps — — select a candidate with verification evidence, install plan, lifecycle contract, next MCP calls, and CLI fallbacks before local build
  • Search — public AI assets by keyword or category with agent fit signals
  • Browse — trending assets, filter by type (MCP, Skill, Prompt, Agent, Script)
  • Get details — — full documentation, install instructions, and metadata
  • Verify trust — — read-only content hash, install plan hash, permission envelope, policy, trust_score_v2, evidence_bundle, SBOM-lite, signature_evidence, blockers, and warnings

The tools it exposes

The server publishes 14 tools. What each one is for:

  • tokrepo_session_init — Session bootstrap with high-trust assets, project memory pointer, recent handoffs, and policy pack URL
  • tokrepo_discover — Planning-time capability discovery from a task, environment, and constraints
  • tokrepo_find_for_task — Atomic find action for a concrete task; returns ranked assets, match reasons, install command, and URL
  • tokrepo_resolve_capability — Resolve a capability gap into a selected asset, verification evidence, install plan, lifecycle contract, next MCP calls, and CLI fallbacks
  • tokrepo_search — Search assets by keyword/tag with agent_fit ranking
  • tokrepo_detail — Get full asset details by UUID
  • tokrepo_edges — Inspect requires, extends, and co-used asset graph edges before planning installs
  • tokrepo_install_plan — Get agent-native install plan v2 with rollback, evidence_bundle, SBOM-lite, and signature_evidence
  • tokrepo_verify — Verify trust, hashes, permissions, policy, evidence_bundle, SBOM-lite, and signature_evidence before activation
  • tokrepo_codex_install — Dry-run, stage, or install a Codex skill safely
  • tokrepo_installed — List TokRepo-managed Codex installs
  • tokrepo_update — Dry-run or update managed Codex installs

What it needs from you

  • Node.js >= 18 - Internet connection (queries tokrepo.com API)

Getting it running

tokrepo-mcp-server on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

How it compares

Plenty of planning and project tracking servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Tokrepo's toolset — tokrepo_session_init, tokrepo_discover, tokrepo_find_for_task and 11 more — is a fair guide to whether it matches your workflow. It is maintained by henu-wang; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Tokrepo.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
tokrepo_session_initSession bootstrap with high-trust assets, project memory pointer, recent handoffs, and policy pack URL
tokrepo_discoverPlanning-time capability discovery from a task, environment, and constraints
tokrepo_find_for_taskAtomic find action for a concrete task; returns ranked assets, match reasons, install command, and URL
tokrepo_resolve_capabilityResolve a capability gap into a selected asset, verification evidence, install plan, lifecycle contract, next MCP calls, and CLI fallbacks
tokrepo_searchSearch assets by keyword/tag with agent_fit ranking
tokrepo_detailGet full asset details by UUID
tokrepo_edgesInspect requires, extends, and co-used asset graph edges before planning installs
tokrepo_install_planGet agent-native install plan v2 with rollback, evidence_bundle, SBOM-lite, and signature_evidence
tokrepo_verifyVerify trust, hashes, permissions, policy, evidence_bundle, SBOM-lite, and signature_evidence before activation
tokrepo_codex_installDry-run, stage, or install a Codex skill safely
tokrepo_installedList TokRepo-managed Codex installs
tokrepo_updateDry-run or update managed Codex installs
tokrepo_uninstallDry-run or remove a managed Codex install
tokrepo_rollbackDry-run or roll back a prior Codex install session

How to install the Tokrepo MCP server

{
  "mcpServers": {
    "tokrepo": {
      "command": "npx",
      "args": ["-y", "tokrepo-mcp-server"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js >= 18 - Internet connection (queries tokrepo.com API)

Example prompts to try

  • Use Tokrepo to tokrepo session init.
  • Use Tokrepo to tokrepo discover.
  • Use Tokrepo to tokrepo find for task.

Frequently asked questions

It connects Tokrepo to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (tokrepo_session_init, tokrepo_discover, tokrepo_find_for_task, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Tokrepo directly.