grant_material_share

All MCP toolsWrite

Share ONE of the person's own materials with the company of ONE of their conversations — the same move as the room's own share button. The company is the conversation's employer, resolved from conversationId (list_conversations): no organization id is taken, and a material can be shared only with a company the person is in conversation with. Read list_material_disclosures first and call this only when the company's standing in that material's shares is not already granted — every call appends a company_granted row, and when the pair's whole-profile disclosure is already full it also records an opened receipt, so a repeat call writes a second act and a second receipt rather than nothing. The company reaches the material only while the pair's whole-profile disclosure is full; a grant made before that stands as a granted standing and the receipt is recorded when the pair reaches full. A closed conversation refuses with reason conversation_closed and writes nothing; a conversation that is not the person's own, or a materialId that is not one of their gate-eligible materials (a url material is not one), refuses with zero writes. Nobody is notified: this is the person's own act. Closing the standing again is withdraw_material_share; answering a company's material request is share_material, not this.

Input schema

{
  "type": "object",
  "properties": {
    "personId": {
      "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)$",
      "description": "The material's owner (persons.id — self)."
    },
    "materialId": {
      "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)$",
      "description": "The material to share — the same id list_materials returns."
    },
    "conversationId": {
      "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)$",
      "description": "One of the person's own conversations (conversationId from list_conversations); its company is the one the material is shared with."
    }
  },
  "required": [
    "personId",
    "materialId",
    "conversationId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

{
  "type": "object",
  "properties": {
    "materialId": {
      "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)$",
      "description": "The material (profile_import_sources.id) — share_material's materialId."
    },
    "organizationId": {
      "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)$",
      "description": "The conversation's company (organizations.id) — the standing's key in shares."
    },
    "organizationName": {
      "type": "string",
      "description": "The organization's display name."
    },
    "state": {
      "type": "string",
      "const": "granted",
      "description": "The standing now in force toward this company."
    },
    "recordedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "When the act was recorded (ISO 8601, UTC) — the appended row's own instant."
    }
  },
  "required": [
    "materialId",
    "organizationId",
    "organizationName",
    "state",
    "recordedAt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}