Quickstart
Two minutes from nothing to your agent searching 1,459,683 licence-cleared components.
1. Get a free API key
Sign up at /signup with your email (no card). Confirm the link we send and copy the key it shows you. It starts with cobalt_live_ and is shown once; you can regenerate it at /account. The Free plan gives you free search plus 30 pull credits on day one, then 10 a day.
2. Connect your agent
The quickest way is the installer. It finds Claude Code, Claude Desktop, Cursor, Windsurf, Codex, OpenClaw and Hermes on your machine and configures each one (VS Code is manual, see below):
npx @justclaw-it/cli init
or, without npm on your PATH:
curl -fsSL https://justclaw.it.com/install | sh
The @justclaw-it/cli 0.1.0 release is rolling out on npm. If npx stops with justclaw-it: not found, use the manual setup for your client below; it is one command or one config entry.
Or set it up by hand. Every client uses the same server URL, https://justclaw.it.com/mcp (Streamable HTTP), and the header Authorization: Bearer <YOUR_API_KEY>:
| client | how | guide |
|---|---|---|
| Claude Code | claude mcp add one-liner | Claude Code |
| Claude Desktop | claude_desktop_config.json via mcp-remote | Claude Desktop |
| Cursor | ~/.cursor/mcp.json | Cursor |
| Windsurf | mcp_config.json with serverUrl | Windsurf |
| VS Code | .vscode/mcp.json with a prompted key | VS Code |
| Codex CLI | ~/.codex/config.toml | Codex |
| OpenClaw | openclaw mcp set | OpenClaw |
| Hermes Agent | ~/.hermes/config.yaml | Hermes Agent |
| anything else | standard bearer header | Other clients |
3. Restart and try it
Restart the agent so it loads the new server, then ask in plain language:
- "Search JustClaw-It for an express JWT auth middleware with a permissive licence."
- "Find a Python Stripe webhook signature check on JustClaw-It and pull the best one into this project."
The agent calls search_components (free), picks a result by fit, score and licence, and calls get_component (1 credit) to pull the source. Keep the attribution header that comes with the code.
4. Check it works
npx @justclaw-it/cli doctor
doctor tests the connection, shows your plan and usage, and lists which agents are configured. Without the CLI:
curl -H "Authorization: Bearer $JUSTCLAW_IT_API_KEY" https://justclaw.it.com/usage
Next
- Tool reference: every tool, parameter and result field.
- Licences & attribution: what you must keep when you reuse a component.
- Agent skills: teach your agent when to search before it writes.
- Troubleshooting if something doesn't connect.