Agents
Requiresagents:read.
These are inspection tools. They cannot change an agent’s instructions, channels, model, or tool grants. Configuration summaries currently read stored release data, so they may not reflect the latest saved Builder configuration; check Builder when those details matter.
Support conversations
Requiresconversations:read. These tools cover web conversations; they are not an export of every channel’s inbox.
An empty query lists conversations within the selected window. The default window is 30 days;
days supports 1–90. Use get_conversation on the returned IDs to review messages. These tools cannot reply to customers, close conversations, or change assignments.
Support analytics
Requiresanalytics:read.
The window is fixed. This tool does not accept custom dates or provide a full analytics dashboard. A suppressed or unavailable value is not zero.
Knowledge and content gaps
Requiresknowledge:read.
Article and gap text is returned verbatim. Search results can include unpublished content; inclusion in a result does not mean an article is public or enabled for an agent.
For gaps,
status can be all, open, addressed, or dismissed and defaults to all. The default window is 45 days; days supports 1–365. Listing gaps does not run new analysis or mark gaps addressed. Manage those actions in Content gaps.
Drafting and editing documentation
Requiresknowledge:write.
For creation,
tenant_id is the target agent ID within the connected workspace. Obtain the correct ID from Chatropic or list_agents if agent reading is authorized. The server checks that it belongs to your workspace.
Draft listings use offset rather than a cursor: the default page size is 25, the maximum is 50, and the maximum offset is 10,000. Inventory results shorten draft and published Markdown to 2,000 characters each. Supply article_id to retrieve the full versions before editing.
An update supplies the complete replacement draft, not a patch. The AI should read the full article, preserve sections outside your requested change, and send its current revision as expected_revision. If another editor has changed it, read again before retrying.
Titles support up to 300 characters and Markdown up to 100,000 characters. provenance records source references used for the documentation. On creation, use a new request_key for each new article; reuse it only to retry an identical request. This helps prevent duplicate drafts after a connection interruption.
Publishing an article
Requiresknowledge:publish, separately from draft editing.
Review the full draft before publishing. Publishing does not automatically enable agent access or opt the article into the public Help Center. Existing visibility settings still apply, so publishing changes to an already-visible article can update what readers see. Review distribution settings in Chatropic’s Knowledge interface.
This publishes a knowledge article; it is not an agent deployment or a requirement for connecting MCP.
Billing and usage
Requiresbilling:read.
Availability depends on the billing provider and recorded data. Missing values mean unavailable, not zero usage or an inactive subscription. These tools cannot change a plan, purchase credits, update payment details, or issue refunds.
Results and limits
Most list tools acceptlimit from 1–100, with a default of 25, and return next_cursor when more results are available. Continue with that cursor using the same tool and search parameters. Do not reuse it with another query or connection. Draft listings use the separate offset pagination described above.
Successful results include a request_id for tracing and a redacted indicator. Knowledge and documentation tools return unredacted content; other categories apply sanitization or redaction. An empty list can mean no matching or accessible records, rather than a server failure.
The server currently allows up to 60 calls per minute per grant, 300 per minute per workspace, and five simultaneous calls per grant. These are execution limits, separate from selecting permission categories. Calls have a 15-second execution timeout and a response-size limit of approximately 250 KB. Narrow the query or reduce the page size if results are too large.
The server does not provide tools for deleting articles, executing arbitrary SQL or code, managing users, changing workspace permissions, or changing agent configuration. Use the Chatropic dashboard for actions outside this catalog.