customers

Read and save this company’s invoice customers. Updating a customer never changes an issued invoice’s frozen snapshot. Each action accepts only its own fields (* required): list; upsert(name*, kind*, address, country, email, id, tax_id). Availability: Autónomo / Empresa. 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

Autónomo / Company schema

{
  "additionalProperties": false,
  "properties": {
    "action": {
      "enum": [
        "list",
        "upsert"
      ],
      "type": "string"
    },
    "address": {
      "description": "Postal address.",
      "type": "string"
    },
    "country": {
      "description": "ISO country code, defaults to ES.",
      "type": "string"
    },
    "email": {
      "description": "Recipient email.",
      "type": "string"
    },
    "id": {
      "description": "Existing customer UUID to update; omit to create.",
      "type": "string"
    },
    "kind": {
      "enum": [
        "company",
        "professional",
        "individual"
      ],
      "type": "string"
    },
    "name": {
      "description": "Name or legal name.",
      "type": "string"
    },
    "tax_id": {
      "description": "Customer NIF or VAT ID.",
      "type": "string"
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

Actions

The family schema combines fields for discovery. Each action accepts only its own fields below; add action when calling the family.

list

Find existing customers in the workspace before preparing an invoice.

{
  "additionalProperties": false,
  "properties": {},
  "type": "object"
}

upsert

Create or update a customer in this workspace. Pass id to update; never changes an issued invoice’s stored customer snapshot.

{
  "additionalProperties": false,
  "properties": {
    "address": {
      "description": "Postal address.",
      "type": "string"
    },
    "country": {
      "description": "ISO country code, defaults to ES.",
      "type": "string"
    },
    "email": {
      "description": "Recipient email.",
      "type": "string"
    },
    "id": {
      "description": "Existing customer UUID to update; omit to create.",
      "type": "string"
    },
    "kind": {
      "enum": [
        "company",
        "professional",
        "individual"
      ],
      "type": "string"
    },
    "name": {
      "description": "Name or legal name.",
      "type": "string"
    },
    "tax_id": {
      "description": "Customer NIF or VAT ID.",
      "type": "string"
    }
  },
  "required": [
    "name",
    "kind"
  ],
  "type": "object"
}

Output

For list, the company’s customers; for upsert, the saved customer record and its identifier for invoice preparation. 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": "customers",
    "arguments": {
      "action": "list"
    }
  }
}
JSON

Connect

Contracts and access

Core tools

Agents and managed-Run tools

Advanced tools

Input

Autónomo / Company schema

Actions

Output

Example

​Input

​Autónomo / Company schema

​Actions

​Output

​Example

Input

Autónomo / Company schema

Actions

Output

Example