TokRepo API & MCP Integration Examples — code samples for searching and integrating AI assets

gist-5-tokrepo-api-examples.md

TokRepo API & MCP Integration Examples

TokRepo is an open registry for AI assets -- skills, prompts, MCP configs, and workflows. This guide shows how to integrate TokRepo into your tools and agents.

Quick Start: CLI Search

The fastest way to search TokRepo's 200+ curated assets:

# Search by keyword
npx tokrepo search "code review"

# Search by category
npx tokrepo search "mcp server config"

# Search for specific asset types
npx tokrepo search "deployment workflow"

No installation required -- npx downloads and runs it on the fly.

MCP Server Integration

For Claude Code

Add TokRepo as an MCP server so your agent can search assets mid-conversation:

// ~/.claude/settings.json
{
  "mcpServers": {
    "tokrepo": {
      "command": "npx",
      "args": ["-y", "tokrepo-mcp-server"]
    }
  }
}

Once configured, Claude Code can search TokRepo directly:

You: "Find me a skill for database migration management"
Agent: Searching TokRepo... Found 3 matching assets:
  1. "prisma-migration-workflow" — Automated Prisma migration with rollback
  2. "sql-migration-guard" — Safe migration patterns for raw SQL
  3. "drizzle-schema-sync" — Keep Drizzle ORM and DB in sync

For Cursor / Windsurf

Create .mcp.json in your project root:

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

Browsing the Registry

Featured Assets

Visit tokrepo.com/en/featured to browse curated collections:

• Skills: Reusable instruction sets for AI agents (code review, testing, deployment)
• Prompts: Battle-tested prompt templates for common tasks
• MCP Configs: Ready-to-use MCP server configurations
• Workflows: Multi-step automation recipes

Search by Category

TokRepo organizes assets by type and use case:

https://tokrepo.com/en/type/skill      -- All skills
https://tokrepo.com/en/type/prompt     -- All prompts
https://tokrepo.com/en/type/mcp-config -- All MCP configs
https://tokrepo.com/en/type/workflow   -- All workflows

Example: Building an Agent with TokRepo Assets

Here's a practical example -- setting up a code review agent that pulls its review checklist from TokRepo:

// review-agent.ts
import { spawn } from "child_process";

async function searchTokRepo(query: string): Promise<string> {
  return new Promise((resolve, reject) => {
    const proc = spawn("npx", ["tokrepo", "search", query]);
    let output = "";
    proc.stdout.on("data", (data) => (output += data));
    proc.on("close", () => resolve(output));
    proc.on("error", reject);
  });
}

// Find the best code review skill for your stack
const results = await searchTokRepo("react typescript code review");
console.log(results);

Contributing Assets

TokRepo is community-driven. To share your own skills, prompts, or workflows:

1. Visit tokrepo.com
2. Sign in with your GitHub account
3. Click "Submit Asset"
4. Fill in the metadata (name, type, description, tags)
5. Paste your asset content
6. Submit for review

Quality assets get featured on the homepage and become searchable by AI agents worldwide.

Use Cases

Scenario	How TokRepo Helps
New project setup	Search for scaffolding workflows and starter configs
Team onboarding	Share your team's skills via a curated collection
Learning new tools	Find prompt templates from experienced practitioners
CI/CD integration	Browse tested deployment and pipeline workflows
Agent development	Discover MCP server configs for common data sources

Links

• Website: tokrepo.com
• MCP Server: npx tokrepo-mcp-server
• CLI: npx tokrepo search "your query"
• Featured Assets: tokrepo.com/en/featured

---

William Wang -- Founder of TokRepo. Building an open registry for the AI agent ecosystem.