@uploadkitdev/mcp

Model Context Protocol server for UploadKit — gives AI coding assistants (Claude Code, Cursor, Windsurf, Zed) first-class knowledge of the UploadKit SDK.

Your AI now knows:

• Every one of UploadKit's 40+ React components (name, category, inspiration, usage)
• How to scaffold the Next.js route handler
• How to wire <UploadKitProvider> into the root layout
• How to configure BYOS (Bring Your Own Storage) for S3, R2, GCS, or Backblaze B2
• Which install command to run for your package manager

No config. No API key. Runs local via npx.

Remote MCP

For clients that cannot spawn npx (ChatGPT custom connectors, Claude.ai web, Smithery), UploadKit also exposes a Streamable HTTP endpoint:

https://api.uploadkit.dev/api/v1/mcp

Same 11-tool surface, read-only, no auth. Full setup: https://docs.uploadkit.dev/docs/guides/mcp#remote-mcp

Install

Add this to your MCP client config.

Claude Code

{
  "mcpServers": {
    "uploadkit": {
      "command": "npx",
      "args": ["-y", "@uploadkitdev/mcp"]
    }
  }
}

…or run: claude mcp add uploadkit -- npx -y @uploadkitdev/mcp

Cursor

Settings → Features → Model Context Protocol → Add new MCP server:

Name:     uploadkit
Command:  npx -y @uploadkitdev/mcp

Windsurf / Zed / Continue

Follow your editor's MCP docs. Command is always npx -y @uploadkitdev/mcp.

Tools

| Tool | What it does | |------|--------------| | list_components | List all UploadKit components, filterable by category | | get_component | Full metadata + usage example for one component | | search_components | Keyword search across names, descriptions, inspirations | | get_install_command | Returns the right install command for your package manager | | scaffold_route_handler | Generates app/api/uploadkit/[...uploadkit]/route.ts | | scaffold_provider | Snippet to wire <UploadKitProvider> into layout.tsx | | get_byos_config | Env + handler for S3 / R2 / GCS / B2 | | get_quickstart | End-to-end Next.js quickstart |

Resources

• uploadkit://catalog — JSON of every component
• uploadkit://quickstart — Next.js setup walkthrough

Example prompts once installed

"Add an Apple-style animated dropzone to this page."

"Set up UploadKit with Cloudflare R2 BYOS mode."

"What's the difference between UploadProgressRadial and UploadProgressOrbit?"

"Create a route handler that accepts up to 4 images of 8MB each."

License

MIT