Limits and formats
The numbers, in one place.
Updated
Requests
| Retrieval requests per workspace | 120 per minute, across every key and connection. Counts get_context, search and get_file, over MCP and REST. Other tools aren't counted. |
get_context budget |
1,000 to 30,000 tokens. Default 12,000. |
| Share of the budget for whole pages | Up to three quarters, for pinned and pack pages. Rules are never cut. |
search results |
Up to 30. Default 8 over MCP, 10 over REST. |
query_table rows per call |
Up to 500. Default 50. |
| File download links | Work for 2 minutes. |
Over the rate limit, MCP tools return an error asking the agent to wait, and the REST API returns 429 with Retry-After: 60. A busy team's agents make a handful of calls per task, so most workspaces never get near it.
Pages
| Section split | At #, ## and ### headings. Deeper headings stay inside their section. |
| Section size | Sections over about 700 tokens are split at paragraph breaks. |
| Token estimate | About 4 characters per token. |
| Page types | company, product, persona, competitor, voice, style, proof, messaging, pricing, faq, other |
| Tag categories | persona, product, competitor, segment, stage, channel, region, or your own |
| Recently deleted | Kept for 90 days. |
| Activity (agent requests) | Kept for 90 days. |
| Refused agent requests and access checks | Kept for 365 days. |
| Page revisions (undo history) | Kept for 365 days. |
| Pending invitations | Expire after 14 days. |
Tables
| Rows per table | 5,000 |
| Columns | 50 |
| Cell size | 4,000 characters |
Rows in read_page |
As many as fit in about 6,000 tokens; the rest through query_table or get_file |
Import
| Text formats | Markdown (.md, .markdown, .mdx), .txt, Word (.docx), PDF, HTML, CSV, zip |
| Kept as files | Excel (.xlsx), PowerPoint (.pptx), and CSV if you choose |
| Size per import | 4 MB, not counting files kept for download |
| Size per kept file | 50 MB |
| Pages per import | 500 |
| Zip contents | At most 500 files or 20 MB once unpacked |
Settings
| Agent instructions | 4,000 characters |
| Server instructions | 8,000 characters |
| Changes to instructions reach agents | Within a minute |
Connections
| MCP transport | Streamable HTTP |
| MCP authentication | OAuth (sign-in) or Bearer API key |
| Sign-in URL | https://getherald.ai/api/mcp |
| Workspace URL | https://getherald.ai/api/mcp/{workspace id} |
| REST base URL | https://getherald.ai/api/v1 |
| API key format | cmcp_ followed by 32 random characters |