Corbits Suite

Probe the Corbits facilitator's capability matrix via GET https://facilitator.corbits.dev/supported. No auth. Returns {kinds: [{x402Version, scheme, network, extra}], extensions: [], signers: {}}. kinds[] enumerates every supported (x402Version, scheme, network) triple — both v1 (friendly names like 'solana-mainnet-beta', 'base', 'polygon', 'monad', 'base-sepolia') and v2 (CAIP-2 IDs like 'eip155:8453' for Base, 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp' for Solana mainnet). extra carries scheme-specific data: feePayer + tokenProgram + features for Solana, contract metadata for EVM. Use BEFORE quoting to confirm the Mind's preferred chain is currently live. Errors: 5xx.

Full-text search across the Corbits Marketplace via GET https://api.corbits.dev/api/v1/search?q=<query>. No auth. Returns a top-level {proxies, endpoints} object — proxies[] is a list of {id, name, org_slug, default_price, default_scheme, tags[], url} with default_price as a micro-USDC integer (multiply by 1e-6 for USDC). endpoints[] are individual endpoint matches when the query hits a path or description. NOT wrapped in a {data} envelope (unlike list/get). Use this as the primary discovery entry point when the Mind has a need expressed in natural language (e.g. 'I need an LLM completion', 'I need Solana RPC'). Errors: 5xx upstream.

Retrieve full proxy details via GET https://api.corbits.dev/api/v1/proxies/{id}. No auth. Returns {data: {id, name, org_slug, default_price, default_scheme, tags[], url, endpoint_count, token_prices[]}}. token_prices[] is the multi-token, multi-network pricing matrix — each entry is {token_symbol, mint_address, network, amount, decimals}. The same logical token (e.g. USDC) can appear multiple times across different networks (solana-mainnet-beta, base, polygon, eip155:137, eip155:143). Always treat amount as a micro-USDC integer for stablecoins (decimals=6). Use after Discover/List to inspect a single candidate before fetching its OpenAPI or quoting an endpoint. Errors: 404 (no such proxy), 5xx.

Retrieve a single endpoint's details via GET https://api.corbits.dev/api/v1/proxies/{id}/endpoints/{endpointId}. No auth. Returns {data: {id, path_pattern, description, price, scheme, tags[]}}. Use to confirm exact pricing for a specific endpoint before quoting. price is micro-USDC integer (multiply by 1e-6 for USDC) or null (use the proxy's default_price). Errors: 404, 5xx.

Fetch the proxy's OpenAPI 3.x specification via GET https://api.corbits.dev/api/v1/proxies/{id}/openapi. No auth. Returns the raw OpenAPI document including Corbits-specific extensions: x-discovery (proxy-level metadata such as registered name, owner, and category) and x-payment-info (per-operation pricing/scheme/network info). Use to plan tool calls against a proxy by reading the operationId, requestBody schema, and responses for each path before quoting. Note: paths in the spec are literal HTTP paths (e.g. /v1/messages); these correspond to the regex path_pattern values returned by ListProxyEndpoints (e.g. ^/v1/messages$). Errors: 404 (no such proxy or no spec registered), 5xx.

Liveness probe for the Corbits Discovery API via GET https://api.corbits.dev/health. No auth. Returns {status: 'ok'} on 200. Use as the first call in any troubleshooting flow before assuming a deeper failure. Errors: 5xx upstream (rare). No request body, no parameters.

List active Corbits Marketplace proxies via GET https://api.corbits.dev/api/v1/proxies?cursor=<cursor>&limit=<limit>. No auth. Returns {data: [{id, name, org_slug, default_price, default_scheme, tags[], url}], pagination: {nextCursor, hasMore}}. default_price is micro-USDC integer (multiply by 1e-6 for USDC). limit defaults to 20, max 100. Cursor is the proxy id of the last item from the previous page; pass pagination.nextCursor verbatim. Use when the Mind wants to browse the catalog rather than search for a specific need. Errors: 5xx upstream.

List configured endpoints for a proxy via GET https://api.corbits.dev/api/v1/proxies/{id}/endpoints?cursor=<cursor>&limit=<limit>. No auth. Returns {data: [{id, path_pattern, description, price, scheme, tags[]}], pagination: {nextCursor, hasMore}}. path_pattern is anchored regex (e.g. ^/evals$, ^/v1/chat/completions$); MATCH literally, do not strip the anchors. price is a micro-USDC integer or null (null means inherit proxy default_price). scheme is 'exact' for fixed pricing, may be 'flex' or null for proxy-default. Errors: 404 (no such proxy), 5xx.

Publish the Mind's identity card to the Corbits Marketplace control plane as a profile-only proxy listing (no backend URL — purely a Discovery entry). Constructs the identity from the Mind's REGISTRY surface: mindId (required, hard reject if missing), name, profileHeadline (null-coerced), species (ethon | moca), steward.type (must be 'human' or 'mind'; hard reject otherwise per Ethoswarm v1.6.0 §3.7), offerings[], seeks[], roles[]. Optional policy_summary block from Corbits_DescribePolicyPosture. WRITE op — requires Steward confirmation. POSTs to the Marketplace control plane (path TBD pending API publication; runtime resolves provider='corbits' to the active control-plane endpoint). Returns {data: {proxyId, slug, listed: bool}}. NEVER include TENET.apiKey entries or any private credential in the identity. Idempotent on mindId — subsequent calls update the existing listing. Errors: 400 (missing/invalid mindId or steward.type), 401 (wallet signature failed), 5xx.

Find other Corbits-registered Minds matching a collaboration intent. GET https://api.corbits.dev/api/v1/search?q=<query> with the Mind's REGISTRY.seeks[] entries as queries; merges results across queries. No auth required for the search itself, but the federation handshake (writing to LTM, sharing offerings/seeks/roles) requires TENET.covenant.federation_consent to be set (hard rejection otherwise). Returns ranked candidate peers as [{peerMindId, name, profileHeadline, species, offerings[], seeks[], roles[], overlap_score, url}]. overlap_score = (this.seeks n peer.offerings) + (this.offerings n peer.seeks) — symmetric intent match. Errors: FEDERATION_CONSENT_MISSING (covenant not set), 5xx.

Surface the explicit 'Book a Call' bridge to the hosted Interchange product. Renders a structured intake document {orgName, agentCount, regulatoryFramework: 'SOC2'|'SEC'|'NFA'|'EU_AI_ACT'|'INTERNAL', currentPainPoints[], expectedScale, contactEmail, mindId}. By default returns the doc to the Steward for manual review and sending. If send=true AND TENET.covenant.allow_interchange_intake_send is set, POSTs to the documented sales-intake endpoint when published (currently the bridge is offline; the tool returns the doc and a 'queued for manual delivery' status). WRITE op — requires Steward confirmation when send=true. Use when (a) the Mind detects org-level scale (e.g. >10 sibling Minds via REGISTRY.steward), (b) regulatory_framework is set explicitly in TENET.covenant, or (c) audit failures repeat across a session.