modelbound-mcp

Local-first MCP server for agent skills. Validate, lint, diff, and convert agent skill files across Cursor, Claude, Kiro, Windsurf, VS Code, and Amazon Q — no account required. Optional cloud sync with ModelBound.

What it does

modelbound-mcp is a small Model Context Protocol server you run locally over stdio. It exposes tools to your IDE / agent:

Local (no API key, no network):

• detect_ide_layout — find which IDE conventions your repo uses
• list_local_skills, read_local_skill, write_local_skill
• lint_skill — front-matter, token count, broken links, TODO scan
• validate_skill_format — agentskills.io compliance
• convert_skill — translate between IDE formats (e.g. Cursor → Claude)

Cloud (with MODELBOUND_API_KEY):

• pull_skill, push_skill, list_cloud_skills, search_cloud, diff_skill
• install_marketplace_skill, get_context_health

The cloud tools are a thin JSON-RPC proxy to mcp.modelbound.co. All business logic stays server-side; this repo never touches your data or secrets.

Install

No install needed:

npx modelbound-mcp

Or install globally:

npm i -g modelbound-mcp

Use as an MCP server

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "modelbound": {
      "command": "npx",
      "args": ["-y", "modelbound-mcp"],
      "env": { "MODELBOUND_API_KEY": "mb_live_..." }
    }
  }
}

MODELBOUND_API_KEY is optional. Without it, local tools still work.

See examples/ for Claude Desktop, Kiro, Windsurf, and VS Code configs.

Use as a CLI

modelbound-mcp detect                                  # which IDE layouts exist here?
modelbound-mcp ls                                      # list every skill file
modelbound-mcp lint .cursor/rules/                     # lint a directory
modelbound-mcp validate ./SKILL.md                     # agentskills.io compliance
modelbound-mcp convert --from cursor --to claude ./rule.mdc > out.md

Contributing

We want help. Specifically:

• New IDE adapters — Zed, Aider, Continue, JetBrains AI, Cline. See CONTRIBUTING.md for the ~50 line recipe.
• Linter rules — token estimation accuracy, dead-link detection, format-specific gotchas.
• Format converters — fidelity improvements between adapter pairs.

Browse good first issues and the roadmap.

License

MIT © ModelBound