Server Clawhub
ClawHub.ai skill catalog MCP server β search, browse, download skills; publish/delete when authenticated
Ask AI about Server Clawhub
Powered by Claude Β· Grounded in docs
I know everything about Server Clawhub. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
@aiwerk/mcp-server-clawhub
MCP server for the ClawHub.ai skill catalog.
Browse, search, inspect, download, and (when authenticated) publish skills from the ClawHub registry through the Model Context Protocol.
Two modes
The server adapts to whether a token is configured:
| Mode | Trigger | Available tools |
|---|---|---|
| anonymous | CLAWHUB_TOKEN unset | 10 read-only tools (search, list, get, scan, moderation, file, resolve, download) |
| authenticated | CLAWHUB_TOKEN set | All 14 tools (adds whoami, publish, delete, undelete) |
The authenticated tools are simply not registered in anonymous mode β tools/list will not advertise them.
Install
Two ways to run this server β pick the one that fits.
Option 1 β Hosted (zero setup)
No local runtime β if you set a token, it's AES-256-GCM encrypted server-side via HashiCorp Vault.
- Sign up at aiwerkmcp.com.
- Install ClawHub from the catalog. Leave
CLAWHUB_TOKENempty for anonymous mode (10 read-only tools), or paste a token to unlock all 14. - Point your MCP client (Claude.ai, Cursor, Hermes, β¦) at your hosted endpoint:
with your Bearer token.https://bridge.aiwerk.ch/u/<your-user-id>/mcp
Option 2 β Self-hosted (npx)
Run directly β you manage the token:
npx -y @aiwerk/mcp-server-clawhub
Or in your MCP client config:
{
"mcpServers": {
"clawhub": {
"command": "npx",
"args": ["-y", "@aiwerk/mcp-server-clawhub"],
"env": {
"CLAWHUB_TOKEN": "optional - unlocks publish/delete/whoami"
}
}
}
}
Tools
Read-only (anonymous + authenticated)
| Tool | Description |
|---|---|
clawhub_search | Search skills by query string β primary discovery path |
clawhub_list_skills | List skills with cursor pagination (see caveat below) |
clawhub_get_skill | Full details for a skill slug |
clawhub_list_versions | List all versions of a skill |
clawhub_get_version | Get a specific version (files + security snapshot) |
clawhub_get_scan | Security scan result for a version |
clawhub_get_moderation | Moderation verdict and evidence (response wraps under moderation) |
clawhub_get_file | Fetch a single raw file from a skill |
clawhub_resolve | Resolve version by content hash |
clawhub_download | Download skill zip (base64 encoded) |
Discovery caveat: the live
/skillsendpoint applies a default server-side filter that may return an emptyitems[]for ungated browsing. In practice, preferclawhub_searchβ it's the reliable entry point for finding skills by keyword. Useclawhub_list_skillswith cursor pagination only when you have a specific filter in mind (e.g.nonSuspiciousOnly=true). ThehighlightedOnlyflag is available onclawhub_searchbut not onclawhub_list_skills.
Wire shapes worth knowing
Some live API responses differ from the published OpenAPI spec. The types in src/types.ts follow
the real wire shape:
clawhub_list_skillsβ{ items: [...], nextCursor }(notskills)clawhub_list_versionsβ{ items: [...], nextCursor }(notversions)clawhub_get_moderationβ{ moderation: { verdict, ... } }(wrapped)clawhub_whoamiβ{ user: { handle, ... } }(wrapped)clawhub_get_moderationreturns 404 for skills with no moderation events β this means clean, not missing. For the always-present verdict, read.moderationfromclawhub_get_skill.
Authenticated only (CLAWHUB_TOKEN required)
| Tool | Description |
|---|---|
clawhub_whoami | Current user (handle, displayName, image) |
clawhub_publish | Publish a new skill version |
clawhub_delete | Soft-delete a skill (reversible) |
clawhub_undelete | Restore a soft-deleted skill |
Environment
| Variable | Required | Purpose |
|---|---|---|
CLAWHUB_TOKEN | no | Bearer token issued by clawhub.ai. Unlocks auth-only tools and raises rate limits (120/min β 600/min for reads). |
CLAWHUB_BASE_URL | no | Override the API base URL. Defaults to https://clawhub.ai/api/v1. |
Rate limits
- Anonymous: 120 reads/min per IP, 30 writes/min per IP
- Authenticated: 600 reads/min per key, 120 writes/min per key
Development
npm install
npm run build
npm test
About AIWerk MCP
Part of the AIWerk MCP platform β curated, signed MCP recipes served either as npm packages for self-hosting or through our multi-tenant hosted bridge (bridge.aiwerk.ch).
Other AIWerk MCP servers:
- @aiwerk/mcp-server-cal β Cal.com scheduling
- @aiwerk/mcp-server-imap β IMAP/SMTP email, provider-agnostic
- @aiwerk/mcp-server-wise β Wise (TransferWise) Personal API, read-only
Browse the full catalog (20+ recipes including GitHub, Linear, Notion, Stripe, β¦) at aiwerkmcp.com.
License
MIT Β© AIWerk
