GeraSkills MCP Server

An MCP server that lets AI agents — Claude Desktop, ChatGPT with tools, Cursor, Windsurf, or any MCP client — search, inspect, and recommend AI skill packs from the GeraSkills marketplace.

The full catalogue (104 skill packs across 12 categories — Healthcare, Legal & Compliance, Education, Home & Lifestyle, Business & Finance, Agriculture & Food, Environment & Sustainability, Real Estate, Personal Finance, Government & Civic, Wellness & Mental Health, Science & Research) is embedded from the real GeraSkills web data. No backend, no network, no auth — every tool answers locally, so it is safe to run anywhere and returns the same skills the live marketplace shows.

Tools

| Tool | What it does | |------|--------------| | search_skills | Full-text search the catalogue with optional filters (category, region, max monthly price, badge). Returns compact cards. | | get_skill | Full detail for one skill by id or name — every capability, both price options, tags, target user, regions, badge, marketplace URL. | | recommend_skills | Given a plain-language goal, return a ranked "skill path" of the most relevant skills, scored by goal-term overlap. | | list_categories | All 12 categories with a skill count each — scope a search before drilling in. | | skills_for_region | Skills explicitly tagged for a region/country (UK, EU, US, Global) — for jurisdiction-specific needs. |

A typical agent flow: list_categories → search_skills (or recommend_skills for a goal) → get_skill for the full record.

Install & run

# Run directly (no global install) once published to npm:
npx -y @gera-services/mcp-gera-skills

# Or from this repo:
cd packages/mcp-gera-skills
npm run build      # tsc --noCheck + copy catalogue -> dist/
node bin/cli.js    # starts on stdio

Client configuration

Claude Desktop / Claude Code (claude_desktop_config.json)

{
  "mcpServers": {
    "gera-skills": {
      "command": "npx",
      "args": ["-y", "@gera-services/mcp-gera-skills"]
    }
  }
}

Local (unpublished) variant — point at the built CLI:

{
  "mcpServers": {
    "gera-skills": {
      "command": "node",
      "args": ["/Users/armen/Gera/packages/mcp-gera-skills/bin/cli.js"]
    }
  }
}

Cursor / Windsurf (.cursor/mcp.json etc.)

{
  "mcpServers": {
    "gera-skills": {
      "command": "npx",
      "args": ["-y", "@gera-services/mcp-gera-skills"]
    }
  }
}

Verify it works

npm run build
node scripts/smoke.mjs

The smoke test speaks raw MCP JSON-RPC over stdio (initialize → tools/list → several tools/call) and asserts the results. Expected output ends with ALL SMOKE CHECKS PASSED.

Example

Ask your agent: "I'm setting up a small UK accountancy practice — what GeraSkills should I look at?"

The agent calls recommend_skills with goal: "run a small UK accountancy practice", region: "UK" and gets back a ranked skill path including bookkeeping-assistant, company-secretary-assistant, and anti-money-laundering-guide, each with its price and marketplace URL.

License

MIT © Gera Systems Ltd