Substrate tools (query/update records)
The substrate tools are the generic record query/update interface exposed through the MCP catalog. The current catalog places them under the CX pillar because contacts, companies, and activities are the primary shipped record targets.
This page is generated from the checked MCP catalog inventory. It intentionally documents only tools that exist in the current Worker manifest. The current public manifest does not include a generic batch-update tool.
Catalog-backed tools
| Source | Value |
|---|---|
| Catalog | apps/ai-coo-cf/src/tools/catalog.ts |
| Manifest schema | 2026-05-01 |
| Generated inventory | docs/src/generated/mcp-catalog.json |
| Catalog pillar | cx |
Read tools
| Tool | Tier | Surfaces | Pagination | Error codes |
|---|---|---|---|---|
inblack_query_records | T1 | public, internal | none | INBLACK_UNAUTHORIZED, INBLACK_FORBIDDEN, INBLACK_VALIDATION_ERROR, INBLACK_NOT_FOUND, INBLACK_RATE_LIMITED, INBLACK_BACKEND_ERROR |
Write tools
| Tool | Tier | Surfaces | Pagination | Simulated by | Error codes |
|---|---|---|---|---|---|
inblack_update_record | T3 | public, internal | none | inblack_simulate_update_record | INBLACK_UNAUTHORIZED, INBLACK_FORBIDDEN, INBLACK_VALIDATION_ERROR, INBLACK_NOT_FOUND, INBLACK_RATE_LIMITED, INBLACK_BACKEND_ERROR, INBLACK_CONFLICT, INBLACK_IDEMPOTENCY_CONFLICT, INBLACK_CONFIRMATION_REQUIRED, INBLACK_AUDIT_UNAVAILABLE |
Simulate tools
| Tool | Tier | Surfaces | Simulates | Error codes |
|---|---|---|---|---|
inblack_simulate_update_record | T1 | public, internal | inblack_update_record | INBLACK_UNAUTHORIZED, INBLACK_FORBIDDEN, INBLACK_VALIDATION_ERROR, INBLACK_NOT_FOUND, INBLACK_RATE_LIMITED, INBLACK_BACKEND_ERROR, INBLACK_NOT_IMPLEMENTED, INBLACK_AUDIT_UNAVAILABLE |
Usage boundary
Use inblack_query_records for read-only record lookup across supported substrate entity types. Use inblack_update_record for a single record update, and use inblack_simulate_update_record to preview the update without changing platform state.
Bulk substrate writes, batch updates, and entity types outside the catalog should not be documented as MCP tools until apps/ai-coo-cf/src/tools/catalog.ts exposes them.