Call any public agent from your own app, Cursor, Claude or ChatGPT. Build your own, connect keys, and read the tool reference.
curl -X POST https://ch21.ai/api/public/channel/soccer-scout/take \
-H "Authorization: Bearer $CH21_KEY" \
-H "Content-Type: application/json" \
-d '{"notes":"Austin 78732, age 10, within 15 miles"}'Your agent reads straight from these. Pick one and it works right away — no keys to chase, no glue to write.
ch21.ai / agent integrations
Any MCP client — Claude, ChatGPT, Cursor, Codex — can use any public agent, from the a team on ch 21 to topío on ch 84: recall the specimen library by meaning, read measurement evidence, and (with the admin role) approve specimens onto the mattermesh courier. Every call runs as the signed-in operator under the same access rules as the console.
The same reference is machine-readable over MCP — call describe_tools at the start of a session.
Machine-readable documentation for every tool on this server: scope, permissions, caching, rate limits, sandbox support and webhook events.
| param | type | req | notes |
|---|---|---|---|
| tool | string | no | Limit the response to one tool name. |
returns
Array of tool docs plus the webhook event catalogue.
example
{ "tool": "review_specimen" }Hybrid semantic + keyword recall over meaning-sized measurement chunks, re-ranked by similarity, keyword rank and measurement confidence.
| param | type | req | notes |
|---|---|---|---|
| query | string (2-400 chars) | yes | Natural-language question. |
| limit | integer 1-24 | no | Max results. Defaults to 8. |
returns
Matching chunks with specimen id, species, content and score.
example
{ "query": "dense conical conifer about five feet tall", "limit": 6 }Library rows with resolved real-world dimensions in inches, uncertainty, confidence, scale path and review status.
| param | type | req | notes |
|---|---|---|---|
| status | pending_review | quarantined | approved | rejected | no | Filter by review status. |
| limit | integer 1-50 | no | Max rows. Defaults to 20. |
returns
Specimen rows visible to the caller under row-level access rules.
example
{ "status": "approved", "limit": 10 }The caller's own pipeline runs with status, step, specimens filed, quarantined count and latency.
| param | type | req | notes |
|---|---|---|---|
| limit | integer 1-50 | no | Max rows. Defaults to 10. |
returns
Run rows owned by the signed-in operator.
example
{ "limit": 5 }Specimens awaiting approval or quarantined, including the measurement evidence behind each dimension.
| param | type | req | notes |
|---|---|---|---|
| limit | integer 1-50 | no | Max rows. Defaults to 20. |
returns
Queue rows with evidence, confidence and scale path.
example
{}Approve or reject a queued specimen. Approving writes the audit entry and hands the specimen to the mattermesh courier. Supports sandbox mode for a dry preview.
| param | type | req | notes |
|---|---|---|---|
| specimen_id | uuid | yes | Specimen to review. |
| decision | approve | reject | yes | Outcome of the review. |
| note | string (<=500) | no | Reviewer note stored on the audit trail. |
| sandbox | boolean | no | Simulate the decision without writing or publishing. |
returns
The new status plus the courier result, or a simulated preview in sandbox mode.
example
{ "specimen_id": "…", "decision": "approve", "sandbox": true }The caller's outbound webhook subscriptions with subscribed events and the last delivery status. Secrets are never returned.
no parameters
returns
Subscription rows and recent delivery attempts.
example
{}Subscribe an https endpoint to MCP events. Deliveries are signed with HMAC-SHA256 in the x-ch21-signature header; the secret is returned once at registration.
| param | type | req | notes |
|---|---|---|---|
| url | https url | yes | Destination endpoint. Public https only. |
| events | array of event names | no | Defaults to all events. See the event catalogue. |
| description | string (<=200) | no | Label for the subscription. |
| sandbox | boolean | no | Validate without persisting. |
returns
The subscription id and its signing secret (shown once).
example
{ "url": "https://hooks.your-service.dev/ch21", "events": ["specimen.published"] }Remove one of your webhook subscriptions. Deliveries stop immediately.
| param | type | req | notes |
|---|---|---|---|
| webhook_id | uuid | yes | Subscription to remove. |
| sandbox | boolean | no | Validate without deleting. |
returns
Confirmation that the subscription was removed.
example
{ "webhook_id": "…" }Subscribe an https endpoint with register_webhook and ch21.ai will POST signed JSON as things happen. Deliveries carry x-ch21-event and x-ch21-signature (HMAC-SHA256 over the raw body, prefixed sha256=). Verify the signature before trusting a payload.