DOC Intel
doc_intelAnalyze readable UTF-8 text or manage a private, resumable file-analysis job. Public text URLs are bounded to 1 MiB; pasted text to 60,000 UTF-16 code units and the complete MCP JSON request to 64 KiB. Private files require an active Zambo capability key and stay in private App Storage; use job_action=create, upload_url, upload_complete, part, status, pause, resume, cancel, review, delete or list. Files are limited to 25 MiB; PDFs to 200 pages; ZIPs to 20 MiB compressed, 50 MiB expanded, 100 text entries and 100:1 expansion. PDFs, images, archives and private repositories are not executed. Scanned pages/images require explicit Groq OCR consent, billed to Zambo with no separate user charge; exact provider USD cost is unavailable. Each analysis part covers at most 24,000 UTF-16 code units; file jobs resume after reconnect, lock source revisions, do not advance failed parts, and require complete range reconciliation and owner review. For larger text jobs keep the same _session_id, continue with offset and expected_source_sha256, collect every range and review before synthesizing. Groq fallbacks use the existing provider account, not a paid overflow service. When unavailable, YOU (the connected AI) can analyze the authenticated source range and submit host_analysis with host_handoff_token using this same tool. A pending handover is not completion and spends no free call; submission is labeled host-AI reported, never independently verified. Use analysis_mode=host_ai to skip Zambo inference entirely. Your AI's own plan still applies. Set require_semantic_analysis:true to retain an error until semantic analysis is submitted. doc_intel includes one completed first-range document preview per network per UTC day. Continuing analysis at next_offset and private file jobs require an active Day Pass or Zambo Pass.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "doc_intel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Public HTTPS UTF-8 text or HTML URL, up to 1 MiB. Not a binary PDF, archive, image or authenticated repository. | |
| _ref | No | Optional handover referral ID from your install link. | |
| note | No | Optional owner review note. | |
| size | No | File size in bytes; file bytes upload directly to the private upload URL. | |
| text | No | Extracted readable text. Full JSON must fit 64 KiB; use smaller excerpts for multi-byte text. URL takes precedence if both are supplied. | |
| No | Legacy compatibility field; email alone never establishes paid access. Use the connected pass credential. | ||
| job_id | No | Private job ID returned by create. | |
| offset | No | Initially 0. Continue with the exact coverage.next_offset returned by the previous part. | |
| decision | No | Owner review decision after all ranges have been reconciled. | |
| filename | No | Original filename for a private file job. | |
| allow_ocr | No | Explicitly permit sending only scanned pages/image files to Groq for OCR after reviewing the returned provider cost disclosure. | |
| _zambo_key | No | Optional opaque Zambo access capability. Never place it in a URL or public log. | |
| job_action | No | Optional private-file job action. Omit to use bounded text/URL analysis. | |
| _session_id | No | Optional stable bot-job ID. Reuse it across calls to bind a Day Pass and keep the job ledger together. | |
| content_type | No | Declared MIME type, checked again against extracted content. | |
| _caller_label | No | Optional caller label recorded as a caller-reported claim in the receipt. | zambo-starter |
| analysis_mode | No | auto tries Groq then delegates to the connected AI. host_ai sends no Zambo inference requests; analyze the returned source excerpt yourself, then submit with this same tool. | |
| host_ai_model | No | Your actual model name, or 'not disclosed'. Stored as caller-reported provenance. | |
| host_analysis | No | Your structured analysis of the recorded range: required title, summary and key_points array; optional doc_type, entities, risks, action_items, sentiment, confidence, word_count_estimate, brief. Recorded as caller reported, not independent verification. | |
| _caller_handle | No | Opaque anonymous continuity handle returned during initialize. Reuse it across MCP sessions; it is not payment authorization. | |
| host_handoff_token | No | Private recorded range token from host_handoff.token. Never share it in a public receipt or link. | |
| receipt_visibility | No | Receipt visibility for this call. Public is the default. Private returns a bearer link; anyone with that link can read it, so keep it secret. The raw token is not stored. | public |
| _continuity_ai_label | No | Optional self-reported AI client label for the private continuity timeline. Zambo does not independently verify the client. | |
| expected_source_sha256 | No | Previous coverage.source_sha256; required for offset > 0. Stops mixed-revision analyses. | |
| require_semantic_analysis | No | If true, retain an error until semantic analysis is complete. A recorded host-AI handover can accompany the error; it is not completed analysis. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| ids | Yes | ||
| next | No | ||
| tier | No | ||
| urls | Yes | ||
| error | No | ||
| graph | No | ||
| active | No | ||
| result | Yes | The tool's observed JSON value or plain-text result. | |
| intents | No | ||
| next_up | No | ||
| payment | No | ||
| day_pass | No | ||
| today_url | No | ||
| expires_at | No | ||
| human_line | Yes | ||
| next_steps | No | ||
| daily_recap | No | ||
| renew_nudge | No | ||
| unlock_link | No | ||
| seconds_left | No | ||
| resume_status | No | ||
| resumed_result | No |