MCP servers
Connect Cursor, VS Code, or Claude to https://mcp.velkinui.com/mcp — or run @velkin/mcp locally.
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 · Cursor skill · llms.txt
Wire your IDE
| IDE | Config file | One command |
|---|---|---|
| Cursor | .cursor/mcp.json | npx velkin-mcp init --client cursor |
| VS Code | .vscode/mcp.json (servers key) | npx velkin-mcp init --client vscode |
| Claude Desktop / Code | .mcp.json | npx velkin-mcp init --client claude |
| Other MCP clients | Same URL in that client's MCP settings | — |
Cursor's init also writes AGENTS.md and a Cursor skill. VS Code uses "servers" instead of "mcpServers":
{
"servers": {
"velkin": {
"url": "https://mcp.velkinui.com/mcp"
}
}
}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 --forceLocal stdio needs peer
@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 — repo contract
- Cursor skill — Cursor-only playbook
- Scaffold & CLI — new apps with MCP pre-wired
- llms.txt — models without MCP