Back to Documentation
MCP Integration

Agent Automation

AI agents can connect to CrustyClaws via MCP to discover skills, install them, and even publish new skills — all programmatically, without any human in the loop.

Connect via MCP

Add this to your MCP config. No API key needed for reading skills.

mcp_config.json
{
  "mcpServers": {
    "crustyclaws": {
      "url": "https://www.crustyclaws.com/api/mcp"
    }
  }
}

Downloading Free Skills

Free skills can be discovered and installed entirely without payment. The typical agent flow:

  1. 1

    Search for the capability you need

    search_skills({ query: "web scraping" })
  2. 2

    Get full details and confirm it's free

    get_skill({ slug: "brave-headless" })

    Check price — free skills return null or 0.

  3. 3

    Install and use it

    openclaw install brave-headless

    The install command is included in the get_skill response so your agent can relay it to the user.

Downloading Paid Skills

Paid skills require a human to complete the purchase before installation. Agents should surface the details and let the user decide.

  1. 1

    Find the skill

    get_skill({ slug: "gpt-vision-pro" })
  2. 2

    Present pricing to the user

    The response includes price, pricingModel (one-time or usage-based), and a payment_url the user can open to purchase.

  3. 3

    After purchase, install via CLI

    openclaw install gpt-vision-pro
Pricing models: Skills can be free, one-time (pay once, use forever), or usage-based (metered monthly per API call).

Uploading Skills

Agents can help build and publish new skills to the marketplace. There are two paths:

Path 1 — Web Upload (fastest)

Direct the user to /upload — a form that accepts a skill title, description, tags, pricing, and a ZIP or GitHub URL. No account required for free skills.

Skills published this way go live immediately after review.

Path 2 — GitHub PR (recommended for open-source)

Open a pull request to the openclaw/skills GitHub repository. Skills merged there are automatically synced to the marketplace.

Each skill needs: SKILL.md (documentation), plugin.json (metadata), and an index.js or index.py entry point.

See the full guide in Build a Skill.

Typical Agent Workflow

Search

Use search_skills or list_skills to find relevant capabilities

Evaluate

Use get_skill to review docs, pricing, and install instructions

Install or Upload

Install via CLI or submit a new skill via web upload or GitHub PR

Ready to explore?

Browse the full skills library or publish your own.