openmandate_create_mandate
Create a new mandate on OpenMandate. Provide what the user is looking for (want) and what they bring to the table (offer). The user's verified contacts are automatically attached.
Returns the mandate with follow-up questions. You MUST relay these questions to the user and collect their actual answers before calling openmandate_submit_answers. Do not answer questions on the user's behalf.
If the user has no verified contacts, they must add one first at https://openmandate.ai/settings or use openmandate_list_contacts to check.
輸入參數want必填offer必填
openmandate_submit_answers
Submit the user's answers to pending intake questions. The mandate must be in 'intake' status with pending questions.
IMPORTANT: Before calling this, you must show each pending question to the user and collect their real answer. Never fabricate or infer answers. OpenMandate may return additional questions. Relay each round to the user until the mandate becomes active.
輸入參數answers必填mandate_id必填
Get a mandate by ID. Returns the mandate's current status, any pending intake questions, and summary once active. Use this to check progress or retrieve questions after creating a mandate.
輸入參數mandate_id必填
openmandate_list_mandates
List the user's open mandates. Returns non-closed mandates by default. Pass status to filter (e.g. status='closed' for history).
輸入參數limitstatus
openmandate_close_mandate
Close (withdraw) a mandate. This is permanent — the mandate will stop matching and cannot be reopened. Only close if the user explicitly wants to withdraw.
輸入參數mandate_id必填
List matches for the authenticated user. Returns matches with compatibility grade, strengths, and concerns. Check this periodically after a mandate becomes active.
輸入參數limit
Get detailed information about a specific match, including compatibility grade, strengths, concerns, and — if both parties accepted — the counterparty's contact information.
輸入參數match_id必填
openmandate_respond_to_match
Accept or decline a match. If you accept and the other party also accepts, contact info is revealed to both sides. Declining is permanent for this match.
輸入參數action必填match_id必填decline_reasondecline_reason_text
openmandate_submit_outcome
Report how a confirmed match went. Available after both parties accepted and contact info was revealed.
Outcomes:
- 'succeeded': Found the right person. Mandate closes.
- 'failed': Didn't work out. Mandate reactivates for new matches.
- 'ongoing': Still in conversation. OpenMandate checks back later.
IMPORTANT: Always confirm the outcome with the user before submitting. This affects their mandate and matching status.
輸入參數outcome必填match_id必填
openmandate_list_contacts
List the user's verified contacts. These are the contacts revealed to the other party on match confirmation. Each contact has an ID, type, display label, and verification status.
無需輸入參數。
Add a new contact for the user. A verification code (OTP) will be sent to the contact address. The user must verify the contact using openmandate_verify_contact before it can be used on mandates.
The first contact added becomes the primary contact automatically.
輸入參數contact_type必填contact_value必填display_label
openmandate_verify_contact
Verify a contact by submitting the OTP code sent to it. The user must check their email for the 8-digit code. After verification, the contact can be used on mandates.
輸入參數code必填contact_id必填
openmandate_update_contact
Update a contact's display label or set it as the primary contact. Setting a contact as primary will unset any other primary contact.
輸入參數contact_id必填is_primarydisplay_label
openmandate_delete_contact
Delete a contact. If the deleted contact was primary, the next verified contact is automatically promoted. This is permanent.
輸入參數contact_id必填
Resend the verification code for a pending contact. Use this if the user didn't receive the code or it expired (codes expire after 10 minutes). Rate limited to 3 per contact per hour.
輸入參數contact_id必填
