Quick Start

Get up and running with CLANKER.NET in 5 minutes.

Step 1: Get Access

Mobile App

  1. Download the clanker app from the App Store
  2. Sign in with Apple ID or GitHub
  3. You start in PAYG mode — purchase credit packs as needed

API Access

  1. Download the mobile app and create an account
  2. Go to Settings → External Agents
  3. Either:
    • Tap ACTIVATE and approve your CLI’s 8-character pair code (Hermes, OpenClaw, Claude Code, …) — see External Agents, or
    • Tap OR NAME A KEY to generate a key for Cursor / VS Code / scripts and copy it on the spot
  4. Use the key as x-api-key: ck_live_… on every REST or MCP call

Step 2: Choose Your Integration

Connect your AI assistant (Claude Desktop, Cursor, VS Code) to clanker.

Claude Desktop Configuration:

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "clanker": {
      "url": "https://clanker.net/mcp/",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Cursor Configuration:

Add to your MCP settings:

{
  "clanker": {
    "url": "https://clanker.net/mcp/",
    "headers": {
      "x-api-key": "YOUR_API_KEY"
    }
  }
}

Option B: REST API

Make HTTP requests directly to our API endpoints.

# List marketplace skills
curl https://clanker.net/api/v1/marketplace/skills \
  -H "x-auth-token: YOUR_AUTH_TOKEN"

# Execute a skill
curl -X POST https://clanker.net/api/v1/skills/readme-generator/run \
  -H "x-auth-token: YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input": "Create a README for my project"}'

Step 3: Run Your First Skill

Via MCP

Once connected, simply ask your AI assistant:

“Search the clanker marketplace for a readme generator and execute it”

The assistant will:

  1. Call search-marketplace or get-skill-details to find matching skills
  2. Call install-skill to add one to your library
  3. Start the run via the REST API (POST /api/v1/skills/:slug/run) and monitor it with get-execution-status

Skills are executed through the REST API, not an MCP tool. Over MCP the assistant discovers and installs skills and monitors runs.

Via Mobile App

  1. Open the app and tap Marketplace
  2. Search for “readme generator”
  3. Tap a skill to view details
  4. Tap Install to add it to your library
  5. Go to Library and tap the skill
  6. Enter your prompt and tap Execute

Need to pair a CLI (Hermes, OpenClaw, Claude Code, …)? Tap Settings → External Agents → Activate and enter the 8-character code your agent printed.

Step 4: View Results

Skill executions can produce:

  • Text output - Displayed directly in the response
  • Artifacts - Files saved to your account (documents, code, images)
  • File diffs - Changes to apply to a codebase (with GitHub + 400 integrations)

Access your artifacts:

  • Mobile: Go to Artifacts tab
  • MCP: Use list-artifacts or download-artifact tools
  • API: GET /api/v1/artifacts

Understanding Credits

Every skill execution costs Dollarinos (Ds):

Token TypeCost
Input tokens1 Ds per 1,000 tokens
Output tokens5 Ds per 1,000 tokens
Minimum per execution10 Ds

PAYG mode: Buy credit packs as needed Based Mode: 2,000 Ds/month + 20% discount on additional packs

Next Steps