Quickstart
Connect your agent in 5 minutes
Get your agent buying, installing, and publishing skills programmatically. No UI required — everything works over a REST API or the MCP server.
Get an API key
Go to Dashboard → Connected agents → New key. Copy the sk_live_… key — it is shown once. Pick only the scopes your agent needs: search, install, purchase, publish.
Find and install a skill
Search the directory, then install to your account. The CLI is the fastest path:
# Search (no key needed)
curl "https://clusters.convex.site/v1/items?q=pdf+forms&kind=skill"
# Install a free skill
npx @cluster-to/cli add pdf-form-filler --target claudeOr install via API — useful when your agent is running in a headless environment:
curl -X POST https://clusters.convex.site/v1/me/installs \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"itemSlug": "pdf-form-filler"}'Buy a paid skill
Paid skills use x402 — HTTP 402 with a USDC payment requirement embedded in the response. Always show the user the price and get explicit consent before paying.
# 1. Check price — the server returns 402 with payment details
curl https://clusters.convex.site/v1/items/my-paid-skill/bundle \
-H "Authorization: Bearer sk_live_…"
# → 402 { "amount": "1.00", "currency": "USDC", "network": "base" }
# 2. After user confirms, pay with the CLI (handles x402 automatically)
npx @cluster-to/cli add my-paid-skill --payFor programmatic payment, set CLUSTERS_PAYMENT_PRIVATE_KEY to a funded Base wallet key. The CLI signs and submits the USDC transfer automatically.
Publish a skill
Publishing requires a developer key (ck_live_…), not an agent key. Get one at Dashboard → Developer → New key. Always get explicit user consent before publishing on their behalf.
# From a directory with a SKILL.md (or any files)
npx @cluster-to/cli login --dev # authenticate once with ck_live_…
npx @cluster-to/cli publish ./my-skillOr post directly to the API:
curl -X POST https://clusters.convex.site/v1/items \
-H "Authorization: Bearer ck_live_…" \
-H "Content-Type: application/json" \
-d '{
"kind": "skill",
"name": "My Skill",
"summary": "One sentence description.",
"descriptionMd": "## My Skill\nWhat it does and how to use it.",
"visibility": "public",
"tags": ["automation"],
"platforms": ["claude-code"]
}'Use the MCP server (optional)
For Claude Code — gives your agent native search_items, install_skill, and publish_item tool calls instead of shell commands.
// .claude/settings.json
{
"mcpServers": {
"clusters": {
"command": "npx",
"args": ["-y", "clusters-mcp"],
"env": {
"CLUSTERS_API_KEY": "sk_live_…"
}
}
}
}Available tools: search_items, get_item, install_skill, pull_raw, publish_item, whoami.
Rules your agent must follow
- • Never spend money without user confirmation — show price, get a yes.
- • Never publish without per-item user consent — ask explicitly each time.
- • Never log or store API keys — treat
sk_live_…like a password. - • On HTTP 402, show the user the price before proceeding — never auto-pay.