Promise

Return a Promise signup URL for users who want agent access to follow-up memory. Safety: Never collects provider credentials in the agent. Send the user to Promise.

{
  "type": "object",
  "properties": {
    "clientName": {
      "type": "string",
      "description": "Name of the agent or MCP client requesting access."
    },
    "returnUrl": {
      "type": "string",
      "description": "HTTPS URL the user can return to after Promise authorization."
    },
    "state": {
      "type": "string",
      "description": "Opaque agent state returned unchanged after authorization."
    },
    "intent": {
      "type": "string",
      "description": "Signup intent to preserve in Promise attribution."
    },
    "scopes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "promise.memory.read",
          "promise.evidence.read",
          "promise.capture.write",
          "promise.followup.write",
          "promise.draft.write"
        ]
      }
    }
  },
  "required": [],
  "additionalProperties": false
}

Return what currently deserves the user's attention. Safety: Return concise items and links back to Promise for sensitive action.

{
  "type": "object",
  "properties": {
    "horizonDays": {
      "type": "integer",
      "minimum": 0,
      "maximum": 30,
      "default": 7
    }
  },
  "required": [],
  "additionalProperties": false
}

List what the user owes and what the user is waiting on. Safety: Do not infer more certainty than Promise returns.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "all",
        "waitingOnMe",
        "waitingOnThem",
        "dueSoon",
        "overdue"
      ],
      "default": "all"
    },
    "scope": {
      "type": "string",
      "enum": [
        "active",
        "snoozed",
        "history"
      ],
      "default": "active"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 25
    }
  },
  "required": [],
  "additionalProperties": false
}

Retrieve a structured Promise commitment or waiting-on item. Safety: Prefer structured status, due dates, people, and source links over raw mail.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Show why Promise believes a follow-up or memory exists. Safety: Return source summaries and citations permitted by the platform API.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Summarize what matters before the user speaks with someone. Safety: Avoid exposing hidden/private fields unless the platform scopes allow them.

{
  "type": "object",
  "properties": {
    "contactId": {
      "type": "string",
      "format": "uuid"
    },
    "query": {
      "type": "string",
      "description": "Name or email search when contactId is unknown."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5
    }
  },
  "required": [],
  "additionalProperties": false
}

Search Promise's derived memory with user authorization. Safety: Search derived Promise memory, not raw provider mailboxes.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Let a user tell Promise something to remember. Safety: Echo what Promise understood and require review when the platform requests it.

{
  "type": "object",
  "properties": {
    "transcript": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "kind": {
      "type": "string",
      "enum": [
        "task",
        "follow_up",
        "remember"
      ],
      "default": "remember"
    },
    "personName": {
      "type": "string"
    },
    "contactId": {
      "type": "string",
      "format": "uuid"
    },
    "dueAt": {
      "type": "string",
      "format": "date-time"
    },
    "requestId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "transcript"
  ],
  "additionalProperties": false
}

Create a future follow-up from explicit user intent. Safety: Only create follow-ups from explicit user instructions.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "transcript": {
      "type": "string"
    },
    "personName": {
      "type": "string"
    },
    "contactId": {
      "type": "string",
      "format": "uuid"
    },
    "dueAt": {
      "type": "string",
      "format": "date-time"
    },
    "requestId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "title"
  ],
  "additionalProperties": false
}

Tell Promise that a commitment or waiting-on item is complete. Safety: Confirm destructive or irreversible status changes in the agent UI.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Draft a follow-up message without sending it. Safety: Do not send email in v1. Return a draft and Promise confirmation link.

{
  "type": "object",
  "properties": {
    "commitmentId": {
      "type": "string",
      "format": "uuid"
    },
    "personName": {
      "type": "string"
    },
    "context": {
      "type": "string"
    },
    "goal": {
      "type": "string"
    }
  },
  "required": [],
  "additionalProperties": false
}