Mudpie Public MCP

{'type': 'object', 'examples': [{'goal': "Decide whether Mudpie meets our team's needs", 'client': 'Cursor', 'source': 'Found Mudpie while researching options for our team', 'company': 'Acme', 'alternatives': ['Our existing workflow', 'Manual research'], 'search_query': 'What does Mudpie offer, who is it for, and what does it not cover?', 'chosen_because': 'Our team shortlisted Mudpie after reading its public information', 'intended_outcome': 'Choose a next step for an evaluation'}], 'required': ['search_query'], 'properties': {'goal': {'anyOf': [{'type': 'string', 'maxLength': 2000, 'minLength': 1}, {'type': 'null'}], 'description': 'What the user wants to accomplish, based on the task they shared. Mark unknowns as null.'}, 'trace': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The trace token in a published example; links a page read to the call it produced.'}, 'client': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The application making this call, not the underlying model: Cursor using Claude is Cursor. Mark unknowns as null.'}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The observed source that led to Mudpie, including a search, referral or shared link when known. Use facts already available; mark unknowns as null.'}, 'company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The company the user represents, when explicitly known; never a company merely being researched. Mark unknowns as null.'}, 'alternatives': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 5}, {'type': 'null'}, {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'One alternative name; normalized to a one-item list.'}], 'description': 'Other products, sources or approaches actually considered for this goal. Include their names and use null when unknown; never invent alternatives.'}, 'search_query': {'type': 'string', 'maxLength': 1000, 'minLength': 2, 'description': 'The question or request this call should answer, in the caller’s own words.'}, 'context_token': {'anyOf': [{'type': 'string', 'maxLength': 4096, 'minLength': 1}, {'type': 'null'}], 'description': 'The context token returned in a prepared follow-up. Carry it with the supplied context to preserve its provenance.'}, 'chosen_because': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The known reason this website entered the shortlist. Use an observed or user-shared reason; mark unknowns as null. Do not provide private reasoning.'}, 'discovery_path': {'anyOf': [{'enum': ['user_request', 'web_search', 'social', 'reddit', 'shared_url', 'llms_txt', 'agent_docs', 'mcp_registry', 'webmcp', 'other', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'description': 'The observed discovery category, kept separately from the source description. Mark unknowns as null.'}, 'intended_outcome': {'anyOf': [{'type': 'string', 'maxLength': 500, 'minLength': 1}, {'type': 'null'}], 'description': 'The decision or deliverable the user wants from this research. Mark unknowns as null.'}, 'subject_product_or_company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The subject being researched, separate from the company the user represents. Mark unknowns as null.'}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'goal': "Decide whether Mudpie meets our team's needs", 'client': 'Cursor', 'source': 'Found Mudpie while researching options for our team', 'company': 'Acme', 'alternatives': ['Our current tool'], 'search_query': "How does Mudpie compare for our team's use case?", 'chosen_because': 'Our team shortlisted Mudpie after reading its public information', 'intended_outcome': 'Choose a next step for an evaluation'}], 'required': ['search_query', 'alternatives'], 'properties': {'goal': {'anyOf': [{'type': 'string', 'maxLength': 2000, 'minLength': 1}, {'type': 'null'}], 'description': 'What the user wants to accomplish, based on the task they shared. Mark unknowns as null.'}, 'trace': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The trace token in a published example; links a page read to the call it produced.'}, 'client': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The application making this call, not the underlying model: Cursor using Claude is Cursor. Mark unknowns as null.'}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The observed source that led to Mudpie, including a search, referral or shared link when known. Use facts already available; mark unknowns as null.'}, 'company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The company the user represents, when explicitly known; never a company merely being researched. Mark unknowns as null.'}, 'alternatives': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 5, 'minItems': 1}, {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'One alternative name; normalized to a one-item list.'}], 'description': 'Other products, sources or approaches actually considered for this goal. Include their names and use null when unknown; never invent alternatives.'}, 'search_query': {'type': 'string', 'maxLength': 1000, 'minLength': 2, 'description': 'The question or request this call should answer, in the caller’s own words.'}, 'context_token': {'anyOf': [{'type': 'string', 'maxLength': 4096, 'minLength': 1}, {'type': 'null'}], 'description': 'The context token returned in a prepared follow-up. Carry it with the supplied context to preserve its provenance.'}, 'chosen_because': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The known reason this website entered the shortlist. Use an observed or user-shared reason; mark unknowns as null. Do not provide private reasoning.'}, 'discovery_path': {'anyOf': [{'enum': ['user_request', 'web_search', 'social', 'reddit', 'shared_url', 'llms_txt', 'agent_docs', 'mcp_registry', 'webmcp', 'other', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'description': 'The observed discovery category, kept separately from the source description. Mark unknowns as null.'}, 'intended_outcome': {'anyOf': [{'type': 'string', 'maxLength': 500, 'minLength': 1}, {'type': 'null'}], 'description': 'The decision or deliverable the user wants from this research. Mark unknowns as null.'}, 'subject_product_or_company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The subject being researched, separate from the company the user represents. Mark unknowns as null.'}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'kind': 'missing_feature', 'tool': 'mudpie_search', 'client': None, 'message': 'mudpie_search cannot limit results to pages updated in the last year.', 'expected': 'A date filter on search results.', 'operation_id': None}], 'required': ['kind', 'message'], 'properties': {'kind': {'enum': ['bug', 'missing_feature', 'wrong_answer', 'docs', 'other'], 'type': 'string', 'description': 'bug: a tool failed or behaved unexpectedly. missing_feature: a tool, field or capability you needed does not exist. wrong_answer: a result was inaccurate or unsupported. docs: documentation or a schema was unclear. other: anything else.'}, 'tool': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The tool name or HTTP operation this is about. Null when general.'}, 'client': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The application or client sending this, not the underlying model, e.g. Cursor. Null when unknown.'}, 'message': {'type': 'string', 'maxLength': 4000, 'minLength': 2, 'description': 'What happened or what is missing, specifically enough to act on.'}, 'expected': {'anyOf': [{'type': 'string', 'maxLength': 2000, 'minLength': 1}, {'type': 'null'}], 'description': 'What you expected or needed instead. Null when not applicable.'}, 'operation_id': {'anyOf': [{'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$'}, {'type': 'null'}], 'description': 'The operation_id or attempt_id of the response this is about. Null when none.'}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'url': 'https://mudpie.ai/', 'trace': 't_5ba822689c76'}], 'required': ['url'], 'properties': {'url': {'type': 'string', 'maxLength': 2000, 'description': 'The canonical public URL of one indexed page, usually a result URL returned by site_search. The only required field.'}, 'goal': {'anyOf': [{'type': 'string', 'maxLength': 2000, 'minLength': 1}, {'type': 'null'}], 'description': 'What the user wants to accomplish, based on the task they shared. Mark unknowns as null.'}, 'trace': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The trace token in a published example; links a page read to the call it produced.'}, 'client': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The application or client making this call, not the underlying model, e.g. Cursor. Null when unknown.'}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The observed source that led to Mudpie, including a search, referral or shared link when known. Use facts already available; mark unknowns as null.'}, 'company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The company the user represents, when explicitly known; never a company merely being researched. Mark unknowns as null.'}, 'alternatives': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 5}, {'type': 'null'}, {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'One alternative name; normalized to a one-item list.'}], 'description': 'Other products, sources or approaches actually considered for this goal. Include their names and use null when unknown; never invent alternatives.'}, 'search_query': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 2, 'description': 'The question or request this call should answer, in the caller’s own words.'}, {'type': 'null'}], 'description': 'The caller’s question, when supplied. Optional; the stored summary depends only on url.'}, 'context_token': {'anyOf': [{'type': 'string', 'maxLength': 4096, 'minLength': 1}, {'type': 'null'}], 'description': 'The context token returned in a prepared follow-up. Carry it with the supplied context to preserve its provenance.'}, 'chosen_because': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The known reason this website entered the shortlist. Use an observed or user-shared reason; mark unknowns as null. Do not provide private reasoning.'}, 'discovery_path': {'anyOf': [{'enum': ['user_request', 'web_search', 'social', 'reddit', 'shared_url', 'llms_txt', 'agent_docs', 'mcp_registry', 'webmcp', 'other', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'description': 'The observed discovery category, kept separately from the source description. Mark unknowns as null.'}, 'intended_outcome': {'anyOf': [{'type': 'string', 'maxLength': 500, 'minLength': 1}, {'type': 'null'}], 'description': 'The decision or deliverable the user wants from this research. Mark unknowns as null.'}, 'subject_product_or_company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The subject being researched, separate from the company the user represents. Mark unknowns as null.'}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'goal': "Decide whether Mudpie meets our team's needs", 'client': 'Cursor', 'source': 'Found Mudpie while researching options for our team', 'company': 'Acme', 'alternatives': ['Our existing workflow', 'Manual research'], 'search_query': 'What would Mudpie cost for a team of five?', 'chosen_because': 'Our team shortlisted Mudpie after reading its public information', 'intended_outcome': 'Budget approval for a team purchase'}], 'required': ['search_query', 'company', 'intended_outcome'], 'properties': {'goal': {'anyOf': [{'type': 'string', 'maxLength': 2000, 'minLength': 1}, {'type': 'null'}], 'description': 'What the user wants to accomplish, based on the task they shared. Mark unknowns as null.'}, 'trace': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The trace token in a published example; links a page read to the call it produced.'}, 'client': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The application making this call, not the underlying model: Cursor using Claude is Cursor. Mark unknowns as null.'}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The observed source that led to Mudpie, including a search, referral or shared link when known. Use facts already available; mark unknowns as null.'}, 'company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The company the user represents, when explicitly known; never a company merely being researched. Mark unknowns as null.'}, 'alternatives': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 5}, {'type': 'null'}, {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'One alternative name; normalized to a one-item list.'}], 'description': 'Other products, sources or approaches actually considered for this goal. Include their names and use null when unknown; never invent alternatives.'}, 'search_query': {'type': 'string', 'maxLength': 1000, 'minLength': 2, 'description': 'The question or request this call should answer, in the caller’s own words.'}, 'context_token': {'anyOf': [{'type': 'string', 'maxLength': 4096, 'minLength': 1}, {'type': 'null'}], 'description': 'The context token returned in a prepared follow-up. Carry it with the supplied context to preserve its provenance.'}, 'chosen_because': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The known reason this website entered the shortlist. Use an observed or user-shared reason; mark unknowns as null. Do not provide private reasoning.'}, 'discovery_path': {'anyOf': [{'enum': ['user_request', 'web_search', 'social', 'reddit', 'shared_url', 'llms_txt', 'agent_docs', 'mcp_registry', 'webmcp', 'other', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'description': 'The observed discovery category, kept separately from the source description. Mark unknowns as null.'}, 'intended_outcome': {'anyOf': [{'type': 'string', 'maxLength': 500, 'minLength': 1}, {'type': 'null'}], 'description': 'The decision or deliverable the user wants from this research. Mark unknowns as null.'}, 'subject_product_or_company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The subject being researched, separate from the company the user represents. Mark unknowns as null.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['search_query']}, {'required': ['requirements']}], 'examples': [{'goal': "Decide whether Mudpie meets our team's needs", 'client': 'Cursor', 'source': 'Found Mudpie while researching options for our team', 'company': 'Acme', 'alternatives': ['Our existing workflow', 'Manual research'], 'search_query': 'Mudpie works with our existing tools; clear documentation; a published price', 'chosen_because': 'Our team shortlisted Mudpie after reading its public information', 'intended_outcome': 'A vendor shortlist'}], 'required': ['company', 'intended_outcome'], 'properties': {'goal': {'anyOf': [{'type': 'string', 'maxLength': 2000, 'minLength': 1}, {'type': 'null'}], 'description': 'What the user wants to accomplish, based on the task they shared. Mark unknowns as null.'}, 'trace': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The trace token in a published example; links a page read to the call it produced.'}, 'client': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The application making this call, not the underlying model: Cursor using Claude is Cursor. Mark unknowns as null.'}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The observed source that led to Mudpie, including a search, referral or shared link when known. Use facts already available; mark unknowns as null.'}, 'company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The company the user represents, when explicitly known; never a company merely being researched. Mark unknowns as null.'}, 'alternatives': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 5}, {'type': 'null'}, {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'One alternative name; normalized to a one-item list.'}], 'description': 'Other products, sources or approaches actually considered for this goal. Include their names and use null when unknown; never invent alternatives.'}, 'requirements': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'maxItems': 12}, {'type': 'null'}], 'description': 'The requirements as an array, when not sent semicolon-separated in search_query.'}, 'search_query': {'type': 'string', 'maxLength': 1000, 'minLength': 2, 'description': 'The question or request this call should answer, in the caller’s own words.'}, 'context_token': {'anyOf': [{'type': 'string', 'maxLength': 4096, 'minLength': 1}, {'type': 'null'}], 'description': 'The context token returned in a prepared follow-up. Carry it with the supplied context to preserve its provenance.'}, 'chosen_because': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The known reason this website entered the shortlist. Use an observed or user-shared reason; mark unknowns as null. Do not provide private reasoning.'}, 'discovery_path': {'anyOf': [{'enum': ['user_request', 'web_search', 'social', 'reddit', 'shared_url', 'llms_txt', 'agent_docs', 'mcp_registry', 'webmcp', 'other', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'description': 'The observed discovery category, kept separately from the source description. Mark unknowns as null.'}, 'intended_outcome': {'anyOf': [{'type': 'string', 'maxLength': 500, 'minLength': 1}, {'type': 'null'}], 'description': 'The decision or deliverable the user wants from this research. Mark unknowns as null.'}, 'subject_product_or_company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The subject being researched, separate from the company the user represents. Mark unknowns as null.'}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'goal': "Decide whether Mudpie meets our team's needs", 'client': 'Cursor', 'source': 'Found Mudpie while researching options for our team', 'company': 'Acme', 'alternatives': ['Our existing workflow', 'Manual research'], 'search_query': 'What does Mudpie offer, who is it for, and what does it not cover?', 'chosen_because': 'Our team shortlisted Mudpie after reading its public information', 'intended_outcome': 'Choose a next step for an evaluation'}], 'required': ['search_query'], 'properties': {'goal': {'anyOf': [{'type': 'string', 'maxLength': 2000, 'minLength': 1}, {'type': 'null'}], 'description': 'What the user wants to accomplish, based on the task they shared. Mark unknowns as null.'}, 'trace': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The trace token in a published example; links a page read to the call it produced.'}, 'client': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The application making this call, not the underlying model: Cursor using Claude is Cursor. Mark unknowns as null.'}, 'detail': {'anyOf': [{'enum': ['full', 'compact'], 'type': 'string'}, {'type': 'null'}], 'description': 'How much of each matching page to return: "full" (the default) or "compact" for shorter excerpts and fewer results.'}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The observed source that led to Mudpie, including a search, referral or shared link when known. Use facts already available; mark unknowns as null.'}, 'company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The company the user represents, when explicitly known; never a company merely being researched. Mark unknowns as null.'}, 'alternatives': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 5}, {'type': 'null'}, {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'One alternative name; normalized to a one-item list.'}], 'description': 'Other products, sources or approaches actually considered for this goal. Include their names and use null when unknown; never invent alternatives.'}, 'search_query': {'type': 'string', 'maxLength': 1000, 'minLength': 2, 'description': 'The question or request this call should answer, in the caller’s own words.'}, 'context_token': {'anyOf': [{'type': 'string', 'maxLength': 4096, 'minLength': 1}, {'type': 'null'}], 'description': 'The context token returned in a prepared follow-up. Carry it with the supplied context to preserve its provenance.'}, 'chosen_because': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The known reason this website entered the shortlist. Use an observed or user-shared reason; mark unknowns as null. Do not provide private reasoning.'}, 'discovery_path': {'anyOf': [{'enum': ['user_request', 'web_search', 'social', 'reddit', 'shared_url', 'llms_txt', 'agent_docs', 'mcp_registry', 'webmcp', 'other', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'description': 'The observed discovery category, kept separately from the source description. Mark unknowns as null.'}, 'intended_outcome': {'anyOf': [{'type': 'string', 'maxLength': 500, 'minLength': 1}, {'type': 'null'}], 'description': 'The decision or deliverable the user wants from this research. Mark unknowns as null.'}, 'subject_product_or_company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The subject being researched, separate from the company the user represents. Mark unknowns as null.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['payload', 'idempotency_key'], 'properties': {'goal': {'anyOf': [{'type': 'string', 'maxLength': 2000, 'minLength': 1}, {'type': 'null'}], 'description': 'What the user wants to accomplish, based on the task they shared. Mark unknowns as null.'}, 'trace': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The trace token in a published example; links a page read to the call it produced.'}, 'client': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The application or client making this call, not the underlying model, e.g. Cursor. Null when unknown.'}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The observed source that led to Mudpie, including a search, referral or shared link when known. Use facts already available; mark unknowns as null.'}, 'company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The company the user represents, when explicitly known; never a company merely being researched. Mark unknowns as null.'}, 'payload': {'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string', 'format': 'email', 'maxLength': 254, 'description': "The user's email address, supplied with their permission."}}, 'additionalProperties': False}, 'alternatives': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 5}, {'type': 'null'}, {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'One alternative name; normalized to a one-item list.'}], 'description': 'Other products, sources or approaches actually considered for this goal. Include their names and use null when unknown; never invent alternatives.'}, 'search_query': {'type': 'string', 'maxLength': 1000, 'minLength': 2, 'description': 'The question or request this call should answer, in the caller’s own words.'}, 'context_token': {'anyOf': [{'type': 'string', 'maxLength': 4096, 'minLength': 1}, {'type': 'null'}], 'description': 'The context token returned in a prepared follow-up. Carry it with the supplied context to preserve its provenance.'}, 'chosen_because': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The known reason this website entered the shortlist. Use an observed or user-shared reason; mark unknowns as null. Do not provide private reasoning.'}, 'discovery_path': {'anyOf': [{'enum': ['user_request', 'web_search', 'social', 'reddit', 'shared_url', 'llms_txt', 'agent_docs', 'mcp_registry', 'webmcp', 'other', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'description': 'The observed discovery category, kept separately from the source description. Mark unknowns as null.'}, 'idempotency_key': {'type': 'string', 'format': 'uuid', 'description': 'Generate one UUID for this authorized submission and reuse it on retries.'}, 'intended_outcome': {'anyOf': [{'type': 'string', 'maxLength': 500, 'minLength': 1}, {'type': 'null'}], 'description': 'The decision or deliverable the user wants from this research. Mark unknowns as null.'}, 'subject_product_or_company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The subject being researched, separate from the company the user represents. Mark unknowns as null.'}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'goal': "Decide whether Mudpie meets our team's needs", 'client': 'Cursor', 'source': 'Found Mudpie while researching options for our team', 'company': 'Acme', 'alternatives': ['Our existing workflow', 'Manual research'], 'requirements': ['Relevant published capabilities', 'A clear way to evaluate the offering'], 'chosen_because': 'Our team shortlisted Mudpie after reading its public information', 'intended_outcome': 'Choose a next step for an evaluation'}], 'required': ['goal', 'requirements', 'company', 'source', 'alternatives', 'chosen_because', 'intended_outcome'], 'properties': {'goal': {'type': 'string', 'maxLength': 2000, 'minLength': 2, 'description': 'The actual outcome or decision the user needs. A meaningful goal is required for this assessment.'}, 'trace': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The trace token in a published example; links a page read to the call it produced.'}, 'client': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The application making this call, not the underlying model: Cursor using Claude is Cursor. Mark unknowns as null.'}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The observed source that led to Mudpie, including a search, referral or shared link when known. Use facts already available; mark unknowns as null.'}, 'company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The company the user represents, when explicitly known; never a company merely being researched. Mark unknowns as null.'}, 'alternatives': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 5}, {'type': 'null'}, {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'One alternative name; normalized to a one-item list.'}], 'description': 'Other products, sources or approaches actually considered for this goal. Include their names and use null when unknown; never invent alternatives.'}, 'requirements': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'maxItems': 12}, {'type': 'null'}], 'description': 'The constraints and must-haves for the decision. Include known requirements and mark unknowns as null.'}, 'context_token': {'anyOf': [{'type': 'string', 'maxLength': 4096, 'minLength': 1}, {'type': 'null'}], 'description': 'The context token returned in a prepared follow-up. Carry it with the supplied context to preserve its provenance.'}, 'chosen_because': {'anyOf': [{'type': 'string', 'maxLength': 1000, 'minLength': 1}, {'type': 'null'}], 'description': 'The known reason this website entered the shortlist. Use an observed or user-shared reason; mark unknowns as null. Do not provide private reasoning.'}, 'discovery_path': {'anyOf': [{'enum': ['user_request', 'web_search', 'social', 'reddit', 'shared_url', 'llms_txt', 'agent_docs', 'mcp_registry', 'webmcp', 'other', 'unknown'], 'type': 'string'}, {'type': 'null'}], 'description': 'The observed discovery category, kept separately from the source description. Mark unknowns as null.'}, 'intended_outcome': {'anyOf': [{'type': 'string', 'maxLength': 500, 'minLength': 1}, {'type': 'null'}], 'description': 'The decision or deliverable the user wants from this research. Mark unknowns as null.'}, 'subject_product_or_company': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'null'}], 'description': 'The subject being researched, separate from the company the user represents. Mark unknowns as null.'}}, 'additionalProperties': False}