skillflow-mcp-server

SkillFlow MCP Server

Connect AI coding agents to the SkillFlow AI skills marketplace. Live data. Zero config. One command.

A Model Context Protocol (MCP) server that connects AI coding agents to the SkillFlow marketplace — a curated AI skills marketplace with trust metrics and performance data.

Why SkillFlow?

AI agents are the new users. Instead of browsing a website, agents can now programmatically search, discover, and evaluate skills from SkillFlow using the MCP protocol.

"It's 2026. Build. For. Agents." — Andrej Karpathy

Key benefits:

• Live API — real-time data from the SkillFlow backend, not hardcoded
• Curated skills across 6 business categories with performance metrics
• Trust metrics — success rates, run counts, ratings, and speed benchmarks
• Zero config — no API keys, no environment variables, just npx
• Works everywhere — Claude Desktop, Cursor, Windsurf, Copilot, Gemini CLI, and any MCP-compatible agent

Transports

This server supports two transports:

Transport	Use Case	Command
stdio	Local use with Claude Desktop, Cursor, etc.	npx skillflow-mcp-server
Streamable HTTP	Remote access via Smithery.ai, cloud agents	skillflow-mcp-http or npm start:http

Quick Start (stdio — Local)

One-liner (npx)

npx skillflow-mcp-server

Claude Desktop

Add to your claude_desktop_config.json:

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

Cursor

Add to .cursor/mcp.json:

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

Windsurf / VS Code / Other MCP Clients

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

Global Installation

npm install -g skillflow-mcp-server
skillflow-mcp

Available Tools

Tool	Description
search_skills	Search for skills by keyword, category, or tag
get_skill_details	Get detailed info about a specific skill including pricing and performance
list_categories	List all skill categories
get_trending_skills	Get currently trending skills
get_platform_stats	Get overall platform statistics (skills, runs, creators, revenue)

Examples

Once connected, ask your AI agent:

• "Search for skills that help with SEO content"
• "What are the trending skills on SkillFlow?"
• "Get details about the blog-seo-writer skill"
• "List all skill categories"
• "Show me the platform stats"
• "Find skills for lead generation"

Quick Start (Streamable HTTP — Remote)

Self-hosted

npm install -g skillflow-mcp-server
PORT=3000 skillflow-mcp-http

Docker

docker build -t skillflow-mcp .
docker run -p 3000:3000 skillflow-mcp

Smithery.ai

Available at: smithery.ai/server/skillflow-mcp-server

HTTP API Endpoints

Method	Path	Description
POST	/mcp	Send JSON-RPC requests (initialize, tools/list, tools/call)
GET	/mcp	Open SSE stream for server notifications
DELETE	/mcp	Terminate a session
GET	/health	Health check (includes live skill count)

Architecture

┌─────────────┐     MCP Protocol     ┌──────────────────┐     tRPC API     ┌──────────────┐
│  AI Agent   │ ◄──────────────────► │ SkillFlow MCP    │ ◄──────────────► │  SkillFlow   │
│ (Claude,    │  stdio / HTTP+SSE    │ Server           │   (live data)    │  Backend     │
│  Cursor...) │                       └──────────────────┘                  └──────────────┘
└─────────────┘

The MCP server acts as a bridge between AI coding agents and the SkillFlow marketplace. It fetches real-time data from the SkillFlow backend API with 5-minute caching for optimal performance.

Listed On

• Official MCP Registry (Anthropic)
• npm
• MCP Market
• mcpservers.org
• Glama.ai
• Smithery.ai

Development

git clone https://github.com/rafsilva85/skillflow-mcp-server.git
cd skillflow-mcp-server
npm install
npm run build
npm start

Contributing

Contributions welcome! Please open an issue or submit a PR.

License

MIT — Rafael Silva

Built with the MCP SDK | Powered by SkillFlow