knowledge_write

Melso Agents is available only internally or by private invitation. Agents-specific features require existing access. For the autónomo fiscal service, see Get started.

Atomically create/update up to 25 pages. Create requires kind and title; root pages also require scope. Update requires page_id and expected_revision. Set body_markdown or append_markdown, never both. Properties patch stable field IDs; null clears a value. Record property writes require expected_schema_revision. Link pages with label. Reuse request_id only for an identical retry. Availability: Autónomo / Empresa / Agents invitation. Catalog: Core (tools/list). The live catalog is authoritative: company type, membership, plan, connected apps and execution context can narrow this contract. Understand access.

Input

Agents / Autónomo / Company schema

{
  "additionalProperties": false,
  "properties": {
    "items": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "enum": [
              "create",
              "update"
            ],
            "type": "string"
          },
          "append_markdown": {
            "type": "string"
          },
          "area_id": {
            "format": "uuid",
            "type": "string"
          },
          "body_markdown": {
            "type": "string"
          },
          "collection_id": {
            "format": "uuid",
            "type": "string"
          },
          "expected_revision": {
            "minimum": 1,
            "type": "integer"
          },
          "expected_schema_revision": {
            "minimum": 1,
            "type": "integer"
          },
          "kind": {
            "enum": [
              "document",
              "collection",
              "record"
            ],
            "type": "string"
          },
          "page_id": {
            "format": "uuid",
            "type": "string"
          },
          "parent_id": {
            "format": "uuid",
            "type": "string"
          },
          "properties": {
            "type": "object"
          },
          "scope": {
            "enum": [
              "company",
              "area",
              "personal"
            ],
            "type": "string"
          },
          "sources": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "label": {
                  "type": "string"
                },
                "retrieved_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              },
              "required": [
                "url"
              ],
              "type": "object"
            },
            "maxItems": 20,
            "type": "array"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "action"
        ],
        "type": "object"
      },
      "maxItems": 25,
      "minItems": 1,
      "type": "array"
    },
    "request_id": {
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "items"
  ],
  "type": "object"
}

Output

The saved Library entry or selected write-operation result. The result uses MCP content blocks; JSON payloads are encoded in text and may also appear in structuredContent. Check isError before reading a success payload. The server does not currently declare an outputSchema, so treat additional fields as extensible. Result handling.

Example

Use an OAuth access token issued for this MCP resource (a Run token for Run-only tools). Replace example identifiers with values from your own account. Write actions change data.

curl --fail-with-body https://melso.ai/api/mcp \
  -H "Authorization: Bearer $MELSO_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data-binary @- <<'JSON'
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "knowledge_write",
    "arguments": {
      "items": [
        {
          "action": "create",
          "kind": "document",
          "title": "Review notes",
          "scope": "company",
          "body_markdown": "Draft notes for review."
        }
      ],
      "request_id": "11111111-1111-4111-8111-111111111111"
    }
  }
}
JSON

Connect

Contracts and access

Core tools

Agents and managed-Run tools

Advanced tools

knowledge_write

Input

Agents / Autónomo / Company schema

Output

Example

​Input

​Agents / Autónomo / Company schema

​Output

​Example

Input

Agents / Autónomo / Company schema

Output

Example