Marmin MCP by usefulapi

Read invoices, credit notes, XML, Peppol status logs and business profiles in Marmin.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
99%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,224Tokens (tool definitions)
~1.6 KBTypical response size
Moderate attention impact (1.74% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "marmin": {
      "url": "https://marmin.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://marmin.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (10)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢marmin_list_business_profiles(name, email, status, page, page_size)

List the Marmin business profiles (legal entities) of this organization, with TRN, TIN, Peppol endpoint and onboarding status. Use profile_id from the result to know which entity a document belongs to. Read-only. Limit: 30 requests/minute.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Partial name match, case-insensitive.",
      "type": "string",
      "maxLength": 200
    },
    "email": {
      "description": "Business contact email.",
      "type": "string",
      "maxLength": 200
    },
    "status": {
      "description": "Onboarding status, for example ONBOARDED or COMPLETED.",
      "type": "string",
      "maxLength": 40
    },
    "page": {
      "description": "Page number, starting at 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Items per page, default 10, maximum 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢marmin_get_business_profile(profile_id)

Get one business profile by its profile_id (for example MBP-00001): legal name, TRN, trade license, Peppol endpoint, address and onboarding status. Read-only.

Input Schema

{
  "type": "object",
  "properties": {
    "profile_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The profile_id from marmin_list_business_profiles."
    }
  },
  "required": [
    "profile_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢marmin_list_documents(kind, document_number, invoice_number, billed_by_name, billed_to_name, ...)

List tax invoices, credit notes or proforma invoices of one kind, newest first as Marmin returns them. Each item has the number, dates, type code (380 invoice, 381 credit note, 389 self-billed, 261 self-billed credit note), parties, amounts and currency. Filter by number, party name, VAT number, status or issue date. Read-only. Limit: 60 requests/minute.

Input Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "sales_invoice",
        "sales_credit_note",
        "purchase_invoice",
        "purchase_credit_note",
        "proforma_invoice"
      ],
      "description": "Document kind. Sales documents are issued by your business profile, purchase documents are received. Proforma invoices are quotes without a tax filing."
    },
    "document_number": {
      "description": "Exact document number.",
      "type": "string",
      "maxLength": 100
    },
    "invoice_number": {
      "description": "Credit notes only: the number of the invoice the credit note refers to.",
      "type": "string",
      "maxLength": 100
    },
    "billed_by_name": {
      "description": "Supplier name.",
      "type": "string",
      "maxLength": 200
    },
    "billed_to_name": {
      "description": "Customer name.",
      "type": "string",
      "maxLength": 200
    },
    "billed_by_vat": {
      "description": "Supplier VAT number (TRN).",
      "type": "string",
      "maxLength": 40
    },
    "billed_to_vat": {
      "description": "Customer VAT number (TRN).",
      "type": "string",
      "maxLength": 40
    },
    "status": {
      "description": "Document status.",
      "type": "string",
      "maxLength": 40
    },
    "document_date": {
      "description": "Issue date, yyyy-MM-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "page": {
      "description": "Page number, starting at 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "size": {
      "description": "Items per page, default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "kind"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢marmin_list_document_uuids(kind, created_on, page, size)

List the ids (UUIDs) of all documents of one kind that were created on one day. Use it to find new documents day by day, then read each with marmin_get_document. Read-only.

Input Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "sales_invoice",
        "sales_credit_note",
        "purchase_invoice",
        "purchase_credit_note",
        "proforma_invoice"
      ],
      "description": "Document kind. Sales documents are issued by your business profile, purchase documents are received. Proforma invoices are quotes without a tax filing."
    },
    "created_on": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Creation date, yyyy-MM-dd (required)."
    },
    "page": {
      "description": "Page number, starting at 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "size": {
      "description": "Ids per page, default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "kind",
    "created_on"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢marmin_get_document(kind, id)

Get one invoice, credit note or proforma invoice by id: parties, lines, tax breakdown, totals (also in AED) and meta_info.peppol_status (overall_status PENDING, APPROVED, REJECTED or VALIDATION_FAILED, with validation_results). Read-only.

Input Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "sales_invoice",
        "sales_credit_note",
        "purchase_invoice",
        "purchase_credit_note",
        "proforma_invoice"
      ],
      "description": "Document kind. Sales documents are issued by your business profile, purchase documents are received. Proforma invoices are quotes without a tax filing."
    },
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{1,64}$",
      "description": "Document id (UUID), as returned by marmin_list_documents."
    }
  },
  "required": [
    "kind",
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢marmin_get_document_xml(kind, id)

Get the UAE e-invoicing XML (UBL 2.1, PINT AE) of an invoice or credit note. Long XML is cut by the server's result size limit. Read-only.

Input Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "sales_invoice",
        "sales_credit_note",
        "purchase_invoice",
        "purchase_credit_note"
      ],
      "description": "Document kind (proforma invoices have no XML)."
    },
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{1,64}$",
      "description": "Document id (UUID), as returned by marmin_list_documents."
    }
  },
  "required": [
    "kind",
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢marmin_get_peppol_status(kind, id)

Get the current Peppol transmission snapshot of an invoice or credit note: the billing leg (toC3, to the buyer's access point) and the tax-reporting leg (toC5, to the FTA), each with status and transmission errors, plus validation results. The XML copies are left out. Needs Phase 2 in the Marmin subscription (else HTTP 404). Read-only.

Input Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "sales_invoice",
        "sales_credit_note",
        "purchase_invoice",
        "purchase_credit_note"
      ],
      "description": "Document kind (proforma invoices have no XML)."
    },
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{1,64}$",
      "description": "Document id (UUID), as returned by marmin_list_documents."
    }
  },
  "required": [
    "kind",
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢marmin_get_peppol_status_log(kind, id)

Get the time-ordered Peppol events of a sales invoice, sales credit note or purchase credit note (DOCUMENT_CREATED, DOCUMENT_SUBMITTED, VALIDATION_SUCCESS and so on) with a message each. Use it to see why a document was rejected. The XML copies are left out. Read-only.

Input Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "sales_invoice",
        "sales_credit_note",
        "purchase_credit_note"
      ],
      "description": "Document kind (purchase invoices have no status log)."
    },
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{1,64}$",
      "description": "Document id (UUID), as returned by marmin_list_documents."
    }
  },
  "required": [
    "kind",
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢marmin_get_register_entry(id)

Get one document register entry (the sales or purchase register of a business profile) by its id, including the linked document_id for e-invoices. Read-only.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{1,64}$",
      "description": "Register entry id."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢marmin_get_codelist(list)

Get a Marmin code list: valid values for invoice fields, for example tax-categories, unit-of-measure-codes, uae-subdivisions (emirate codes), currencies, credit-note-reason-codes, payment-means-modes, tax-exemption-reason-codes. Read-only.

Input Schema

{
  "type": "object",
  "properties": {
    "list": {
      "type": "string",
      "enum": [
        "countries",
        "registration-types",
        "tax-schemes",
        "tax-categories",
        "payment-means-modes",
        "unit-of-measure-codes",
        "electronic-address-schemes",
        "peppol-supported-document-types",
        "credit-note-reason-codes",
        "uae-subdivisions",
        "tax-exemption-reason-codes",
        "transaction-type-codes",
        "currencies",
        "discount-reason-codes",
        "charge-reason-codes"
      ],
      "description": "Name of the code list."
    }
  },
  "required": [
    "list"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded10 tools