# Soap Bucket

> Soap Bucket is a collection of AI tools: a catalog (clictl), a gateway (SBproxy), and an LLM-jury test runner for MCP servers. Each one is independent and self-hostable.

## About

Soap Bucket is a collection of AI tools for the gap between APIs and AI agents. There is no single product and no platform to adopt; there are three tools, and you can pick up any one without the others. The catalog (clictl) is the package manager that turns any API, CLI, MCP server, or skill into a sandboxed tool an agent can find and call without custom integration code. The gateway (SBproxy) is a reverse proxy that doubles as an AI gateway, governing every API, every agent, and every model from one self-hostable runtime. The test runner puts an LLM jury in front of every MCP server in the catalog: real models call your server, snapshots capture what they do, and a diff catches the model-drift regressions (tool selection, argument shape, retry behavior) that schema validators and integration tests cannot see. All three ship as single static binaries with auditable supply chains.

## Products and Projects

### SBproxy
- Website: https://sbproxy.dev
- Documentation: https://sbproxy.dev/docs
- GitHub: https://github.com/soapbucket/sbproxy
- License: Apache 2.0
- SBproxy is the AI Governance Gateway. One self-hostable runtime that governs every API, every agent, and every model. Inbound monetization (Pay Per Crawl, x402, MPP, virtual keys), agent identity (Web Bot Auth, RFC 9421 message signatures), content for agents (HTML to Markdown, RSL, llms.txt), and outbound AI governance (40+ models, MCP federation, budgets, guardrails). Runs in your VPC, region, Kubernetes cluster, or air-gapped environment.

#### Features
- Pay-per-crawl with x402
- Auto OpenAPI emission for every API
- 40+ AI providers behind one endpoint
- PII redacted before the prompt leaves your network
- Agent identity: Web Bot Auth, RFC 9421 HTTP message signatures
- MCP federation across multiple servers
- Cost-optimized AI routing with budget controls
- AI guardrails with content filtering
- WAF (Web Application Firewall) with configurable rulesets
- DDoS protection with automatic mitigation
- Rate limiting with sliding window and token bucket algorithms
- Multi-tier caching (in-memory, distributed, stale-while-revalidate)
- CEL, Lua, and JavaScript scripting for custom request/response logic
- WASM plugin support for extensibility
- HTTP/2, HTTP/3, WebSocket, gRPC, and GraphQL support
- Single static binary, no interpreter on the execution path, no package manager at startup

### clictl (clee-cuttle)
- Website: https://clictl.dev
- Documentation: https://clictl.dev/docs
- Tool Browser: https://clictl.dev/browse
- clictl is the catalog layer of the Soap Bucket AI stack. A package manager that gives AI agents the ability to search, install, and call APIs, CLIs, MCP servers, and skills without custom glue code or bespoke MCP servers.

#### Features
- 223+ curated tool specifications from various APIs, CLIs, and MCP servers
- Works as both a CLI tool and an MCP server
- Works with Claude Code, GPT, and other AI agents
- Built-in authentication and credential management
- Request and response transforms
- Sandboxed execution with declared permissions (network, filesystem, environment)
- Tool specs are shareable through public or private repositories called toolboxes
- Static, declarative tool specs: no install-time code execution
- No custom integration code required

## How the two pieces fit together

- Agents discover tools through the **clictl** catalog. Each tool spec declares what it expects, what it returns, and what permissions it needs.
- Tool calls flow through **SBproxy**, the gateway that handles auth, rate limiting, AI routing, observability, and inbound monetization.

Catalog, gateway, tests. A collection of AI tools that fit together, or stand on their own.

## People

### Rick Crawford
- GitHub: https://github.com/rickcrawford
- LinkedIn: https://linkedin.com/in/rickcrawford
- Founder of Soap Bucket LLC. Builds enterprise software with deep experience in API infrastructure and AI systems. Creator of SBproxy and clictl.

## Contact

- Email: contact@soapbucket.com
- Company Website: https://soapbucket.com
- SBproxy Website: https://sbproxy.dev
- clictl Website: https://clictl.dev
- GitHub (Company): https://github.com/soapbucketllc
- GitHub (Rick Crawford): https://github.com/rickcrawford
- LinkedIn: https://linkedin.com/in/rickcrawford