Skip to content

rafsilva85/skillflow-mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SkillFlow MCP Server

npm version npm downloads MCP Registry License: MIT Available on SkillFlow

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

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

About

MCP Server for SkillFlow - Connect AI coding agents to 500+ curated AI skills. Zero config, no API keys. Works with Claude, Cursor, Windsurf, Copilot.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors