OpenMandate is in private development and is not accepting new mandates or integrations.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer API key for an existing OpenMandate account. New integrations are not accepted.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
The contact address to add (e.g. email address).
Optional human-readable label (e.g. 'Work email'). Defaults to the contact type.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
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.
| Argument | Type | Description |
|---|---|---|
| contact_type* | string | Contact type. |
| contact_value* | string | The contact address to add (e.g. email address). |
| display_label | string | Optional human-readable label (e.g. 'Work email'). Defaults to the contact type. |
{
"type": "object",
"required": [
"contact_type",
"contact_value"
],
"properties": {
"contact_type": {
"enum": [
"email"
],
"type": "string",
"description": "Contact type."
},
"contact_value": {
"type": "string",
"description": "The contact address to add (e.g. email address)."
},
"display_label": {
"type": "string",
"description": "Optional human-readable label (e.g. 'Work email'). Defaults to the contact type."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| mandate_id* | string | The mandate ID to close. |
{
"type": "object",
"required": [
"mandate_id"
],
"properties": {
"mandate_id": {
"type": "string",
"description": "The mandate ID to close."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| want* | string | What the user is looking for (cofounder, service provider, investor, etc.). Minimum 20 characters. |
| offer* | string | What the user brings to the table (skills, experience, resources, etc.). Minimum 20 characters. |
{
"type": "object",
"required": [
"want",
"offer"
],
"properties": {
"want": {
"type": "string",
"description": "What the user is looking for (cofounder, service provider, investor, etc.). Minimum 20 characters."
},
"offer": {
"type": "string",
"description": "What the user brings to the table (skills, experience, resources, etc.). Minimum 20 characters."
}
}
}Delete a contact. If the deleted contact was primary, the next verified contact is automatically promoted. This is permanent.
| Argument | Type | Description |
|---|---|---|
| contact_id* | string | The contact ID to delete. |
{
"type": "object",
"required": [
"contact_id"
],
"properties": {
"contact_id": {
"type": "string",
"description": "The contact ID to delete."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| mandate_id* | string | The mandate ID to retrieve. |
{
"type": "object",
"required": [
"mandate_id"
],
"properties": {
"mandate_id": {
"type": "string",
"description": "The mandate ID to retrieve."
}
}
}Get detailed information about a specific match, including compatibility grade, strengths, concerns, and — if both parties accepted — the counterparty's contact information.
| Argument | Type | Description |
|---|---|---|
| match_id* | string | The match ID to retrieve. |
{
"type": "object",
"required": [
"match_id"
],
"properties": {
"match_id": {
"type": "string",
"description": "The match ID to retrieve."
}
}
}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.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}List the user's open mandates. Returns non-closed mandates by default. Pass status to filter (e.g. status='closed' for history).
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of mandates to return (default 20, max 100). |
| status | string | Filter by status: intake, active, matched, pending_input, closed. |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"description": "Maximum number of mandates to return (default 20, max 100)."
},
"status": {
"enum": [
"intake",
"active",
"matched",
"pending_input",
"closed"
],
"type": "string",
"description": "Filter by status: intake, active, matched, pending_input, closed."
}
}
}List matches for the authenticated user. Returns matches with compatibility grade, strengths, and concerns. Check this periodically after a mandate becomes active.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of matches to return (default 20, max 100). |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"description": "Maximum number of matches to return (default 20, max 100)."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| contact_id* | string | The contact ID to resend verification for. |
{
"type": "object",
"required": [
"contact_id"
],
"properties": {
"contact_id": {
"type": "string",
"description": "The contact ID to resend verification for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| action* | string | Either 'accept' or 'decline'. |
| match_id* | string | The match ID to respond to. |
| decline_reason | string | Why the user is declining. Only used when action is 'decline'. |
| decline_reason_text | string | Free-text detail when decline_reason is 'other'. |
{
"type": "object",
"required": [
"match_id",
"action"
],
"properties": {
"action": {
"enum": [
"accept",
"decline"
],
"type": "string",
"description": "Either 'accept' or 'decline'."
},
"match_id": {
"type": "string",
"description": "The match ID to respond to."
},
"decline_reason": {
"enum": [
"wrong_skills",
"stage_mismatch",
"location",
"not_enough_info",
"already_found",
"other"
],
"type": "string",
"description": "Why the user is declining. Only used when action is 'decline'."
},
"decline_reason_text": {
"type": "string",
"description": "Free-text detail when decline_reason is 'other'."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| answers* | array | Array of answers to pending questions. |
| mandate_id* | string | The mandate ID to submit answers for. |
{
"type": "object",
"required": [
"mandate_id",
"answers"
],
"properties": {
"answers": {
"type": "array",
"items": {
"type": "object",
"required": [
"question_id",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "Answer value. For text: your answer string. For single_select: the option value. For multi_select: comma-separated option values (e.g. 'python, go')."
},
"question_id": {
"type": "string",
"description": "Question ID from pending_questions."
}
}
},
"description": "Array of answers to pending questions."
},
"mandate_id": {
"type": "string",
"description": "The mandate ID to submit answers for."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| outcome* | string | Match outcome. |
| match_id* | string | The match ID to report outcome for. |
{
"type": "object",
"required": [
"match_id",
"outcome"
],
"properties": {
"outcome": {
"enum": [
"succeeded",
"ongoing",
"failed"
],
"type": "string",
"description": "Match outcome."
},
"match_id": {
"type": "string",
"description": "The match ID to report outcome for."
}
}
}Update a contact's display label or set it as the primary contact. Setting a contact as primary will unset any other primary contact.
| Argument | Type | Description |
|---|---|---|
| contact_id* | string | The contact ID to update. |
| is_primary | boolean | Set to true to make this the primary contact. |
| display_label | string | New display label for the contact. |
{
"type": "object",
"required": [
"contact_id"
],
"properties": {
"contact_id": {
"type": "string",
"description": "The contact ID to update."
},
"is_primary": {
"type": "boolean",
"description": "Set to true to make this the primary contact."
},
"display_label": {
"type": "string",
"description": "New display label for the 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.
| Argument | Type | Description |
|---|---|---|
| code* | string | The 8-digit verification code from the email. |
| contact_id* | string | The contact ID to verify. |
{
"type": "object",
"required": [
"contact_id",
"code"
],
"properties": {
"code": {
"type": "string",
"description": "The 8-digit verification code from the email."
},
"contact_id": {
"type": "string",
"description": "The contact ID to verify."
}
}
}