Marmin MCP by usefulapi
Read invoices, credit notes, XML, Peppol status logs and business profiles in Marmin.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"marmin": {
"url": "https://marmin.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://marmin.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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"
}커뮤니티
증거