mcp.parzley.com

Analyse Content

Analyze document content against a user query in a simple, direct way. **Prerequisite:** Call **`get_form_with_shortcode`** first with the user’s shortcode and wait until it succeeds. Use identifiers from that response (`session_id`, `crew_shortcode`, `form_id`, and — when the flow requires it — the **6-character session shortcode** from **`parzley_message_turn`**). Do not call this tool before a Parzley session has been initiated. USER EXPERIENCE (waiting, long input, and stepping away): - *

Register Respondent

Register a respondent record linked to the current session. **Prerequisite:** Call **`get_form_with_shortcode`** first with the user’s shortcode and wait until it succeeds. Use identifiers from that response (`session_id`, `crew_shortcode`, `form_id`, and — when the flow requires it — the **6-character session shortcode** from **`parzley_message_turn`**). Do not call this tool before a Parzley session has been initiated. **When to call:** Only after **`session_shortcode`** (6-character) exists

Extract Content

Extract raw text / vision description from an uploaded file. **Prerequisite:** Call **`get_form_with_shortcode`** first with the user’s shortcode and wait until it succeeds. Use identifiers from that response (`session_id`, `crew_shortcode`, `form_id`, and — when the flow requires it — the **6-character session shortcode** from **`parzley_message_turn`**). Do not call this tool before a Parzley session has been initiated. USER EXPERIENCE (waiting, long input, and stepping away): - **Mandatory

Get Form Data Feedback

Retrieve **feedback on the current session’s form data** — errors, shortfalls, missing fields, validation issues, and answer-quality notes. This complements the concierge in `parzley_message_turn`, which guides *what to ask next*; this call surfaces *what is wrong or incomplete* in what has been captured so far. **Prerequisite:** Call **`get_form_with_shortcode`** first with the user’s shortcode and wait until it succeeds. Use identifiers from that response (`session_id`, `crew_shortcode`, `for

Get Form Data By Session

Retrieve saved form field values for a session (`GET /form-data/by-session/{session_id}`). **Not shortcode lookup:** `session_id` is the **internal session identifier** returned by **`get_form_with_shortcode`** (typically a UUID string). **Do not** pass a **5- or 6-character shortcode** — crew codes and session shortcodes are **not** `session_id`. To resolve a shortcode, call **`get_form_with_shortcode(shortcode)`** first, then use the returned **`session_id`** here. **Prerequisite:** Call **`

Get Form With Shortcode

**When the user gives a 5- or 6-character shortcode, call this tool — not `get_schema`.** Start a new Parzley form-filling session and resolve the shortcode to `session_id`, `crew_shortcode`, and `form_id`. This MUST be the first Parzley tool called. You have access to Parzley — an AI-powered data collection (form filling) platform. **Tool set (9 tools, always registered):** `get_form_with_shortcode`, `parzley_message_turn`, `register_respondent`, `get_schema`, `get_form_data_by_session`, `ge

Get Schema

Retrieve the **full form schema / definition** for a **MongoDB form ObjectId** (`GET /forms/{form_object_id}`). **Use this only after you have the long ObjectId** — not when the user only gave a shortcode. **Wrong identifier → 400 / not found:** This is **not** shortcode resolution. **Do not** pass a **5- or 6-character shortcode** (crew or session) as `form_object_id` — that calls the wrong resource. To turn a shortcode like `oZSUD` into `form_id` / `session_id` / `crew_shortcode`, call **`ge

Parzley Message Turn

Send a user message to Parzley — fires concierge_chat AND chat_with_agents simultaneously in a single call. The concierge is the admin-configured agent for the crew’s form; it runs the user-facing dialogue (use its reply for the user). This is the ONLY tool you need to call on every user message after get_form_with_shortcode. It runs both API calls in parallel and returns their combined responses. This tool is the only MCP surface for those behaviors — do not assume separate tools exist for th

Submit Form Data

Submit Form Data — final submission: locks the form, persists Parzley-held data, and runs downstream workflows. Irreversible — the form cannot be reopened or unsubmitted. **Prerequisite:** Call **`get_form_with_shortcode`** first with the user’s shortcode and wait until it succeeds. Use identifiers from that response (`session_id`, `crew_shortcode`, `form_id`, and — when the flow requires it — the **6-character session shortcode** from **`parzley_message_turn`**). Do not call this tool before a