Marmin MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.0.0Updated Nov 14, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Read-only access to Marmin UAE e-invoicing data: invoices, credit notes, UBL XML, Peppol status and business profiles.

What you can do
  • List and read business profiles with TRN, Peppol endpoint and onboarding status
  • List invoices, credit notes and proforma invoices, or document ids created on a given day
  • Read a document's parties, lines, tax breakdown, totals and its UBL 2.1 PINT AE XML
  • Check Peppol transmission status and the time-ordered status log to see why a document was rejected
  • Look up register entries and code lists such as tax categories, units of measure and emirate codes
  • Check monthly usage and manage the subscription plan
When to use it
Useful when you work with UAE e-invoicing in Marmin and want an assistant to look up invoices, trace Peppol delivery or rejection reasons, or check business profile and register details without opening the dashboard.
Requirements
Remote hosted endpoint; no local install. Connect with the server URL only and sign in through OAuth, providing the environment (production or sandbox), a Client ID starting with org_ and a Client Secret from the Marmin Developer Dashboard. A Marmin account is required; the free plan allows 50 tool calls per month.
Before you install
You hand over Marmin API credentials (Client ID and Client Secret) during OAuth sign-in; the server stores them per user. Paid plans cost money: Pro at $9/month or $90/year and Pro+ at $39/month or $390/year, billed through a Stripe Checkout link, and upgrading from Pro to Pro+ charges the price difference immediately with no refund on cancellation. The listed tools are read-only, but meta tools can change your subscription.

Installation

In SourceWeft

  1. Open Marmin MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fmarmin/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "marmin-by-usefulapi": {
      "type": "http",
      "url": "https://marmin.usefulapi.io/mcp"
    }
  }
}

README

Marmin MCP by usefulapi

Use your Marmin account from Claude, Cursor, or any MCP client. Read UAE e-invoices, credit notes, Peppol status and business profiles. Hosted, no local install: connect with your own credentials.

Live endpoint: https://marmin.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://marmin.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http marmin https://marmin.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "marmin": {      "url": "https://marmin.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Marmin credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/marmin/

On first connect you provide the Environment (production or sandbox), your Client ID (starts with org_) and your Client Secret (shown after an email code). Find them in the Marmin Developer Dashboard, under Settings, then API Configuration. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
marmin_list_business_profilesreadList business profiles
marmin_get_business_profilereadGet a business profile
marmin_list_documentsreadList documents
marmin_list_document_uuidsreadList document ids created on a day
marmin_get_documentreadGet a document
marmin_get_document_xmlreadGet the UBL XML of a document
marmin_get_peppol_statusreadGet the Peppol status of a document
marmin_get_peppol_status_logreadGet the Peppol status log of a document
marmin_get_register_entryreadGet a register entry
marmin_get_codelistreadGet a code list
marmin_usage_statusmetaUsage status (free-tier meter)
marmin_request_featuremetaRequest a missing feature
marmin_upgrademetaUpgrade to Pro or Pro+
marmin_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run marmin_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with marmin_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with marmin_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/marmin/README.md at commit 6d32263

Tools

10

marmin_list_business_profiles

List business profiles

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.

Parametersnamepageemailstatuspage_size

marmin_get_business_profile

Get a business profile

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.

Parametersprofile_idrequired

marmin_list_documents

List documents

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.

Parameterskindrequiredpagesizestatusbilled_by_vatbilled_to_vatdocument_datebilled_by_namebilled_to_nameinvoice_numberdocument_number

marmin_list_document_uuids

List document ids created on a day

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.

Parameterskindrequiredpagesizecreated_onrequired

marmin_get_document

Get a document

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.

Parametersidrequiredkindrequired

marmin_get_document_xml

Get the UBL XML of a document

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.

Parametersidrequiredkindrequired

marmin_get_peppol_status

Get the Peppol status of a document

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.

Parametersidrequiredkindrequired

marmin_get_peppol_status_log

Get the Peppol status log of a document

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.

Parametersidrequiredkindrequired

marmin_get_register_entry

Get a register entry

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.

Parametersidrequired

marmin_get_codelist

Get a code 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.

Parameterslistrequired

Version history

1
  1. v1.0.0LatestNov 14, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations