Marmin MCP by usefulapi
Read invoices, credit notes, XML, Peppol status logs and business profiles in Marmin.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"marmin": {
"url": "https://marmin.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://marmin.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (10)
🟢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.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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
Nachweis