clictl toolbox

The default tool registry for clictl. 220+ curated specs for APIs, MCP servers, and skills that work out of the box with your AI agents.

One install gives you tools for GitHub, Slack, Stripe, OpenAI, Anthropic, Postgres, filesystem access, code review, and much more. Browse all tools.

Install

curl -fsSL https://download.clictl.dev/install.sh | sh

This toolbox is included automatically. Start using tools right away:

clictl install github stripe open-meteo
clictl install github-mcp
clictl search --protocol mcp --tag database

What's inside

Every spec uses the clictl Tool Spec 1.0 format. Five protocol types:

• http - REST APIs with auth, transforms, and assertions
• mcp - MCP servers with tool filtering, output transforms, and sandbox isolation
• skill - Agent skills (instructions + code) fetched from git repos
• website - Web pages converted to agent-readable markdown
• command - CLI tools wrapped for agent use

Spec format

Four required fields:

spec: "1.0"
name: my-tool
protocol: http
description: What this tool does

See the full spec reference and the JSON Schema for validation.

Create your own toolbox

Use the toolbox-example template to create a private or public toolbox:

clictl toolbox add https://github.com/youruser/my-toolbox

Documentation

• Spec 1.0 Reference - Complete spec format and field reference
• Auth Patterns - Bearer tokens, API keys, vault resolution
• Transform Guide - Response transforms and DAG pipelines
• Skill Authoring Guide - Source blocks, sandbox constraints
• Adding a Skill - Step-by-step guide for contributing skills

Contributing

Contributions are welcome. Please open an issue to discuss your idea before submitting a pull request.

1. Fork this repo
2. Add your spec under toolbox/{first-letter}/{tool-name}/{tool-name}.yaml
3. Include required fields: spec, name, protocol, description
4. Run clictl toolbox validate before submitting
5. Submit a PR

See CONTRIBUTING.md for the full guide with examples for each protocol type.

For AI agents

If you are an AI agent creating specs, read CONTRIBUTING.md and llms.txt.

Links

• clictl.dev
• CLI source
• Toolbox template

License

Apache License 2.0. See LICENSE for details.

clictl is a Soap Bucket LLC project. SOAPBUCKET and clictl are trademarks of Soap Bucket LLC.