MCP servers
Connect Cursor, VS Code, Windsurf, Claude, Zed, Cline, or JetBrains to https://mcp.velkinui.com/mcp.
Connect in 30 seconds
Point any MCP client at the hosted Velkin server. No npm install. Agents then read live component docs instead of inventing props.
{
"mcpServers": {
"velkin": {
"url": "https://mcp.velkinui.com/mcp"
}
}
}AI docs: MCP · AGENTS.md · Agent skills · llms.txt
Wire your IDE
Velkin supports all major AI coding environments. Use the hosted remote endpoint https://mcp.velkinui.com/mcp for zero-install instant setup, or the @velkin/mcp npm package for offline local stdio.
Cursor Setup
Cursor connects via .cursor/mcp.json or through Cursor Settings → Features → MCP. Configure it manually or generate the full setup in one command.
Writes .cursor/mcp.json, root AGENTS.md, and .cursor/skills/velkin/SKILL.md:
npx velkin-mcp init --client cursorPaste into .cursor/mcp.json in your project root:
{
"mcpServers": {
"velkin": {
"url": "https://mcp.velkinui.com/mcp"
}
}
}{
"mcpServers": {
"velkin": {
"command": "npx",
"args": ["-y", "@velkin/mcp"]
}
}
}Quick Reference & Environment Matrix
Compare setup locations and protocols across all supported environments:
| Client / IDE | Config file or command | Protocol |
|---|---|---|
| Cursor | .cursor/mcp.json or npx velkin-mcp init --client cursor | Remote SSE / Stdio |
| VS Code / Copilot | .vscode/mcp.json (servers key) or --client vscode | Remote SSE / Stdio |
| Claude Desktop | claude_desktop_config.json (macOS & Windows) | Stdio (command) |
| Claude Code CLI | claude mcp add velkin https://mcp.velkinui.com/mcp | Remote SSE / Stdio |
| Codex CLI | codex mcp add velkin https://mcp.velkinui.com/mcp | Remote SSE / Stdio |
| Windsurf | .windsurf/mcp.json or ~/.codeium/windsurf/mcp_config.json | serverUrl / Stdio |
| Gemini CLI | gemini mcp add velkin https://mcp.velkinui.com/mcp | Remote SSE / Stdio |
| Cline / Roo Code | cline_mcp_settings.json / Extension MCP UI | Remote SSE / Stdio |
| Antigravity | .agents/mcp_config.json or ~/.gemini/config/mcp_config.json | Remote SSE / Stdio |
| JetBrains IDEs | Settings → Tools → Model Context Protocol | Remote SSE / Stdio |
| Zed | .zed/settings.json under context_servers | Stdio (command) |
| Neovim (Avante / mcphub) | require("mcphub").setup({ servers = { velkin = ... } }) | Stdio (command) |
| Multi-client automated CLI | npx velkin-mcp init --client all --force | Automated CLI |
What agents should call
suggest_component/velkin_components— find a componentget_velkin_component_docswithcompact: true— props, events, slotsget_component_usageorget_recipes— starter codevalidate_component_usagethenvelkin_lint— before shipping
Also useful: diff_component_migration, get_theme, get_a11y_guide, get_project_guide. Put standing rules in AGENTS.md.
When you need the npm package
Most teams only use the remote URL. Install @velkin/mcp when you need offline stdio, to pin a version, or to run init / --health.
{
"mcpServers": {
"velkin": {
"command": "npx",
"args": ["-y", "@velkin/mcp"]
}
}
}npm install -D @velkin/mcp @velkin/ui
npx velkin-mcp --health
npx velkin-mcp init --client all --force@velkin/ui for the docs snapshot. The hosted URL does not.Common problems
| Symptom | Fix |
|---|---|
| Tools missing in the IDE | Confirm the URL is https://mcp.velkinui.com/mcp, reload MCP, or re-run init --force |
velkin-mcp --health fails | Install peer @velkin/ui, or switch to the remote URL |
| Agent invents props | Require get_velkin_component_docs in AGENTS.md / skill; run velkin_lint |
| No MCP in the chat product | Use llms.txt instead |
Next steps
- AGENTS.md — universal repo contract
- Agent skills — playbooks across Cursor, Antigravity, Claude, and more
- Scaffold & CLI — new apps with multi-agent readiness
- llms.txt — models and chat environments without MCP