{
  "markdown": "# SkillFlow MCP Server\n\n[![npm version](https://img.shields.io/npm/v/skillflow-mcp-server.svg)](https://www.npmjs.com/package/skillflow-mcp-server)\n[![npm downloads](https://img.shields.io/npm/dm/skillflow-mcp-server.svg)](https://www.npmjs.com/package/skillflow-mcp-server)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-Published-green)](https://registry.modelcontextprotocol.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Available on SkillFlow](https://raw.githubusercontent.com/rafsilva85/awesome-ai-skills/main/badges/skillflow-available.svg)](https://skillflow.builders)\n\n> Connect AI coding agents to the SkillFlow AI skills marketplace. Live data. Zero config. One command.\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that connects AI coding agents to the [SkillFlow](https://skillflow.builders) marketplace — a curated AI skills marketplace with trust metrics and performance data.\n\n## Why SkillFlow?\n\nAI 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.\n\n> \"It's 2026. Build. For. Agents.\" — Andrej Karpathy\n\n**Key benefits:**\n- **Live API** — real-time data from the SkillFlow backend, not hardcoded\n- **Curated skills** across 6 business categories with performance metrics\n- **Trust metrics** — success rates, run counts, ratings, and speed benchmarks\n- **Zero config** — no API keys, no environment variables, just `npx`\n- **Works everywhere** — Claude Desktop, Cursor, Windsurf, Copilot, Gemini CLI, and any MCP-compatible agent\n\n## Transports\n\nThis server supports two transports:\n\n| Transport | Use Case | Command |\n|-----------|----------|----------|\n| **stdio** | Local use with Claude Desktop, Cursor, etc. | `npx skillflow-mcp-server` |\n| **Streamable HTTP** | Remote access via Smithery.ai, cloud agents | `skillflow-mcp-http` or `npm start:http` |\n\n## Quick Start (stdio — Local)\n\n### One-liner (npx)\n\n```bash\nnpx skillflow-mcp-server\n```\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"skillflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"skillflow-mcp-server\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"skillflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"skillflow-mcp-server\"]\n    }\n  }\n}\n```\n\n### Windsurf / VS Code / Other MCP Clients\n\n```json\n{\n  \"mcpServers\": {\n    \"skillflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"skillflow-mcp-server\"]\n    }\n  }\n}\n```\n\n### Global Installation\n\n```bash\nnpm install -g skillflow-mcp-server\nskillflow-mcp\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_skills` | Search for skills by keyword, category, or tag |\n| `get_skill_details` | Get detailed info about a specific skill including pricing and performance |\n| `list_categories` | List all skill categories |\n| `get_trending_skills` | Get currently trending skills |\n| `get_platform_stats` | Get overall platform statistics (skills, runs, creators, revenue) |\n\n## Examples\n\nOnce connected, ask your AI agent:\n\n- *\"Search for skills that help with SEO content\"*\n- *\"What are the trending skills on SkillFlow?\"*\n- *\"Get details about the blog-seo-writer skill\"*\n- *\"List all skill categories\"*\n- *\"Show me the platform stats\"*\n- *\"Find skills for lead generation\"*\n\n## Quick Start (Streamable HTTP — Remote)\n\n### Self-hosted\n\n```bash\nnpm install -g skillflow-mcp-server\nPORT=3000 skillflow-mcp-http\n```\n\n### Docker\n\n```bash\ndocker build -t skillflow-mcp .\ndocker run -p 3000:3000 skillflow-mcp\n```\n\n### Smithery.ai\n\nAvailable at: [smithery.ai/server/skillflow-mcp-server](https://smithery.ai/server/skillflow-mcp-server)\n\n### HTTP API Endpoints\n\n| Method | Path | Description |\n|--------|------|-------------|\n| `POST` | `/mcp` | Send JSON-RPC requests (initialize, tools/list, tools/call) |\n| `GET` | `/mcp` | Open SSE stream for server notifications |\n| `DELETE` | `/mcp` | Terminate a session |\n| `GET` | `/health` | Health check (includes live skill count) |\n\n## Architecture\n\n```\n┌─────────────┐     MCP Protocol     ┌──────────────────┐     tRPC API     ┌──────────────┐\n│  AI Agent   │ ◄──────────────────► │ SkillFlow MCP    │ ◄──────────────► │  SkillFlow   │\n│ (Claude,    │  stdio / HTTP+SSE    │ Server           │   (live data)    │  Backend     │\n│  Cursor...) │                       └──────────────────┘                  └──────────────┘\n└─────────────┘\n```\n\nThe 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.\n\n## Listed On\n\n- [Official MCP Registry](https://registry.modelcontextprotocol.io) (Anthropic)\n- [npm](https://www.npmjs.com/package/skillflow-mcp-server)\n- [MCP Market](https://mcpmarket.com)\n- [mcpservers.org](https://mcpservers.org)\n- [Glama.ai](https://glama.ai/mcp/servers)\n- [Smithery.ai](https://smithery.ai/server/skillflow-mcp-server)\n\n## Development\n\n```bash\ngit clone https://github.com/rafsilva85/skillflow-mcp-server.git\ncd skillflow-mcp-server\nnpm install\nnpm run build\nnpm start\n```\n\n## Contributing\n\nContributions welcome! Please open an issue or submit a PR.\n\n## License\n\nMIT — [Rafael Silva](https://github.com/rafsilva85)\n\n---\n\nBuilt with the [MCP SDK](https://github.com/modelcontextprotocol/sdk) | Powered by [SkillFlow](https://skillflow.builders)\n",
  "bytes": 5540,
  "sha": "3837676ebdef73093a8fc0ef9f35b37a6342ae4d00048c0574ed973f94a50a32",
  "repo_slug": "rafsilva85/skillflow-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rafsilva85_skillflow_d8a713fd/readme"
}