Skip to content

sshadmand/skillbase

v1.1.0

Use and sync Skillbase skills from Cursor via MCP OAuth.

Skillbase Cursor plugin

Connect Cursor to Skillbase over MCP:

  • Sign in with the browser — Cursor opens Skillbase; you allow access (OAuth). No token paste.
  • Remote skillsget_skill loads markdown into the chat (no download)
  • Selective syncprepare_install packages a Cursor SKILL.md; the agent writes it to .cursor/skills/ (or ~/.cursor/skills/)
  • Bundled skillsskillbase + skillbase-sync teach the agent when to use each path

The MCP server is hosted by the Skillbase web app (/api/mcp), not this repo.

Setup

  1. Install this plugin (Marketplace or local symlink below).
  2. Optional: set SKILLBASE_MCP_URL for a local Skillbase (http://localhost:3100/api/mcp). Default is production.
  3. Enable the Skillbase MCP server — Cursor should prompt you to sign in in the browser.

Local test

ln -s "$(pwd)" ~/.cursor/plugins/local/skillbase

Reload Cursor. Point SKILLBASE_MCP_URL at your local app if needed.

Manual mcp.json

{
  "mcpServers": {
    "skillbase": {
      "url": "https://app.skillbase.club/api/mcp"
    }
  }
}

Cursor handles OAuth when the server challenges with 401 + protected-resource metadata.

Publish

Public repo: https://github.com/sshadmand/skillbase-cursor
Submit at cursor.com/marketplace/publish.

MCP tools

ToolPurpose
whoamiConnected account
list_skillsAccessible catalog
get_skillRemote use
prepare_installCursor skill package + write path
get_skill_metaMetadata only