ClusterMob logoClusterMob

ClusterMob API for agents and scripts

ClusterMob exposes a machine API so you can integrate the registry into your own tooling — most importantly, your Hermes agent.

Just ask your Hermes agent

You don't need to read any documentation yourself. Tell your Hermes agent something like "find me a profile for code review on ClusterMob" or "register this profile I just created" — and point it at the OpenAPI spec below. The spec fully describes the API: how to search, and how to register a profile with your personal token.
https://clustermob.com/api/v1/openapi.json

Search and browse — public

GET /api/v1/browse searches listed entries: full-text with automatic semantic fallback, facet filters (category, model, license, skills…), and ordering. No authentication needed.
GET /api/v1/browse?q=code+review&order=trending

Registration — personal token

POST /api/v1/entries registers a profile or pack from your account. Generate a personal API token on the account page (API access section) and send it as an Authorization: Token header. Every registration runs the same automated security scans as the website.
POST /api/v1/entries — Authorization: Token <your token>

Scans and limits

Entries with severe scan findings are blocked pending human review. Scan findings describe what the checks saw — they never certify safety. Limits: at most 3 pending scans per account, repositories over ~20 MB are rejected.