MCP Black Shader

Connect your AI assistant to 470+ premium web animation projects. Semantic code search for GSAP, Three.js, Lenis, Framer Motion, and more.

What is this?

MCP Black Shader gives your AI assistant (Claude, Cursor, Windsurf, VS Code, etc.) access to a curated library of 470+ real-world web animation projects through the Model Context Protocol.

14 tools for code intelligence:

| Tool | Description | |------|-------------| | blackshader_search_code | Semantic code search across all projects | | blackshader_get_project_files | Retrieve files from indexed projects | | blackshader_list_capabilities | Available animation/web capabilities | | blackshader_list_technologies | Technology stack discovery | | blackshader_get_docs | Documentation links | | blackshader_get_usage | Code usage patterns | | blackshader_discover | Project discovery | | blackshader_suggest_structure | Architecture suggestions | | blackshader_plan_build | Build planning | | blackshader_get_template_code | Template code | | blackshader_get_step_context | Contextual steps | | blackshader_get_component_code | Component code | | blackshader_get_project_manifest | Project metadata | | blackshader_get_full_project | Full project dump |

Quick Start

1. Get your API Key

Sign up and get your API key at blackshader.com/dashboard.

2. Configure your AI assistant

Claude Desktop / Claude Code

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "blackshader": {
      "command": "npx",
      "args": ["-y", "mcp-black-shader"],
      "env": {
        "BLACKSHADER_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "blackshader": {
      "command": "npx",
      "args": ["-y", "mcp-black-shader"],
      "env": {
        "BLACKSHADER_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "blackshader": {
      "command": "npx",
      "args": ["-y", "mcp-black-shader"],
      "env": {
        "BLACKSHADER_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

3. Use it

Once configured, ask your AI assistant things like:

• "Search for GSAP scroll-triggered animations"
• "Show me Three.js particle effects projects"
• "Find Lenis smooth scrolling implementations"
• "Get the code for a parallax hero section"
• "List all projects using Framer Motion"

Plans

| Feature | Starter | Pro | Enterprise | |---------|---------|-----|-----------| | Search queries/day | 100 | 500 | Unlimited | | Code delivery/day | 10K chars | 50K chars | Unlimited | | Projects access | All 470+ | All 470+ | All 470+ | | Priority support | — | ✓ | ✓ |

See blackshader.com/pricing for details.

Requirements

• Node.js 20+
• A valid BlackShader API key

Support

• Website: blackshader.com
• Issues: GitHub Issues

License

MIT — © BlackShader