Marmin MCP by usefulapi is an MCP server published by io.usefulapi, hosted at marmin.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 10 tools, including marmin_list_business_profiles, marmin_get_business_profile, marmin_list_documents, marmin_list_document_uuids, marmin_get_document.
Read invoices, credit notes, XML, Peppol status logs and business profiles in Marmin.
4,319 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| name | string | Partial name match, case-insensitive. |
| page | integer | Page number, starting at 0. |
| string | Business contact email. | |
| status | string | Onboarding status, for example ONBOARDED or COMPLETED. |
| page_size | integer |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| Items per page, default 10, maximum 100. |
{
"name": "marmin_list_business_profiles",
"title": "List business profiles",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"description": "Partial name match, case-insensitive."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Page number, starting at 0."
},
"email": {
"type": "string",
"maxLength": 200,
"description": "Business contact email."
},
"status": {
"type": "string",
"maxLength": 40,
"description": "Onboarding status, for example ONBOARDED or COMPLETED."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, default 10, maximum 100."
}
}
},
"annotations": {
"title": "List business profiles",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| profile_id * | string | The profile_id from marmin_list_business_profiles. |
{
"name": "marmin_get_business_profile",
"title": "Get a business profile",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"profile_id"
],
"properties": {
"profile_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The profile_id from marmin_list_business_profiles."
}
}
},
"annotations": {
"title": "Get a business profile",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | Document kind. Sales documents are issued by your business profile, purchase documents are received. Proforma invoices are quotes without a tax filing. |
| page | integer | Page number, starting at 0. |
| size | integer | Items per page, default 10. |
| status | string | Document status. |
| billed_by_vat | string | Supplier VAT number (TRN). |
| billed_to_vat | string | Customer VAT number (TRN). |
| document_date | string | Issue date, yyyy-MM-dd. |
| billed_by_name | string | Supplier name. |
| billed_to_name | string | Customer name. |
| invoice_number | string | Credit notes only: the number of the invoice the credit note refers to. |
| document_number | string | Exact document number. |
{
"name": "marmin_list_documents",
"title": "List documents",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"sales_invoice",
"sales_credit_note",
"purchase_invoice",
"purchase_credit_note",
"proforma_invoice"
],
"type": "string",
"description": "Document kind. Sales documents are issued by your business profile, purchase documents are received. Proforma invoices are quotes without a tax filing."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Page number, starting at 0."
},
"size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, default 10."
},
"status": {
"type": "string",
"maxLength": 40,
"description": "Document status."
},
"billed_by_vat": {
"type": "string",
"maxLength": 40,
"description": "Supplier VAT number (TRN)."
},
"billed_to_vat": {
"type": "string",
"maxLength": 40,
"description": "Customer VAT number (TRN)."
},
"document_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Issue date, yyyy-MM-dd."
},
"billed_by_name": {
"type": "string",
"maxLength": 200,
"description": "Supplier name."
},
"billed_to_name": {
"type": "string",
"maxLength": 200,
"description": "Customer name."
},
"invoice_number": {
"type": "string",
"maxLength": 100,
"description": "Credit notes only: the number of the invoice the credit note refers to."
},
"document_number": {
"type": "string",
"maxLength": 100,
"description": "Exact document number."
}
}
},
"annotations": {
"title": "List documents",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | Document kind. Sales documents are issued by your business profile, purchase documents are received. Proforma invoices are quotes without a tax filing. |
| page | integer | Page number, starting at 0. |
| size | integer | Ids per page, default 10. |
| created_on * | string | Creation date, yyyy-MM-dd (required). |
{
"name": "marmin_list_document_uuids",
"title": "List document ids created on a day",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind",
"created_on"
],
"properties": {
"kind": {
"enum": [
"sales_invoice",
"sales_credit_note",
"purchase_invoice",
"purchase_credit_note",
"proforma_invoice"
],
"type": "string",
"description": "Document kind. Sales documents are issued by your business profile, purchase documents are received. Proforma invoices are quotes without a tax filing."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Page number, starting at 0."
},
"size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Ids per page, default 10."
},
"created_on": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Creation date, yyyy-MM-dd (required)."
}
}
},
"annotations": {
"title": "List document ids created on a day",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Document id (UUID), as returned by marmin_list_documents. |
| kind * | string | Document kind. Sales documents are issued by your business profile, purchase documents are received. Proforma invoices are quotes without a tax filing. |
{
"name": "marmin_get_document",
"title": "Get a document",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9-]{1,64}$",
"description": "Document id (UUID), as returned by marmin_list_documents."
},
"kind": {
"enum": [
"sales_invoice",
"sales_credit_note",
"purchase_invoice",
"purchase_credit_note",
"proforma_invoice"
],
"type": "string",
"description": "Document kind. Sales documents are issued by your business profile, purchase documents are received. Proforma invoices are quotes without a tax filing."
}
}
},
"annotations": {
"title": "Get a document",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Document id (UUID), as returned by marmin_list_documents. |
| kind * | string | Document kind (proforma invoices have no XML). |
{
"name": "marmin_get_document_xml",
"title": "Get the UBL XML of a document",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9-]{1,64}$",
"description": "Document id (UUID), as returned by marmin_list_documents."
},
"kind": {
"enum": [
"sales_invoice",
"sales_credit_note",
"purchase_invoice",
"purchase_credit_note"
],
"type": "string",
"description": "Document kind (proforma invoices have no XML)."
}
}
},
"annotations": {
"title": "Get the UBL XML of a document",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Document id (UUID), as returned by marmin_list_documents. |
| kind * | string | Document kind (proforma invoices have no XML). |
{
"name": "marmin_get_peppol_status",
"title": "Get the Peppol status of a document",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9-]{1,64}$",
"description": "Document id (UUID), as returned by marmin_list_documents."
},
"kind": {
"enum": [
"sales_invoice",
"sales_credit_note",
"purchase_invoice",
"purchase_credit_note"
],
"type": "string",
"description": "Document kind (proforma invoices have no XML)."
}
}
},
"annotations": {
"title": "Get the Peppol status of a document",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Document id (UUID), as returned by marmin_list_documents. |
| kind * | string | Document kind (purchase invoices have no status log). |
{
"name": "marmin_get_peppol_status_log",
"title": "Get the Peppol status log of a document",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9-]{1,64}$",
"description": "Document id (UUID), as returned by marmin_list_documents."
},
"kind": {
"enum": [
"sales_invoice",
"sales_credit_note",
"purchase_credit_note"
],
"type": "string",
"description": "Document kind (purchase invoices have no status log)."
}
}
},
"annotations": {
"title": "Get the Peppol status log of a document",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Register entry id. |
{
"name": "marmin_get_register_entry",
"title": "Get a register entry",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9-]{1,64}$",
"description": "Register entry id."
}
}
},
"annotations": {
"title": "Get a register entry",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| list * | string | Name of the code list. |
{
"name": "marmin_get_codelist",
"title": "Get a code list",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list"
],
"properties": {
"list": {
"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"
],
"type": "string",
"description": "Name of the code list."
}
}
},
"annotations": {
"title": "Get a code list",
"readOnlyHint": true
}
}Tools for Marmin, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "List my sales invoices from this week and show the Peppol status of each."; "Why was invoice INV-001 rejected? Show the Peppol status log."; "Show the purchase invoices from supplier VAT number 100123456700003.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Marmin data. Free plan: 50 tool calls per month. Run marmin_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run marmin_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run marmin_upgrade without a plan: it returns both plans, each with a payment link for the user to open. marmin_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.