com.debitura/mcp-server

Official16 toolsLive

by debitura · TypeScript

Cross-border debt collection: submit and track cases handled by local partners in 183 countries.

Debitura MCP Server

The com.debitura/mcp-server is an MCP server for cross-border debt collection. It lets MCP-compatible agents submit and track cases that are handled by local partners in 183 countries. The server targets developers using Model Context Protocol (MCP) clients in Node.js environments.

🛠️ Key Features

Cross-border debt collection case submission and tracking
Uses local partners across 183 countries
Built as an MCP server (Model Context Protocol)

🚀 Use Cases

Integrate an MCP-compatible workflow with Debitura debt collection operations
Track the status of cases across international partners

⚡ Developer Benefits

Works with MCP-compatible agents such as Claude, Cursor, and VS Code
Node.js (Node version shown as ≥20)
Aligned with MCP and labeled as a TypeScript-oriented project context (topic)

⚠️ Limitations

Server scope is specific to debt collection and related case handling via Debitura

Topics

accounts-receivableai-agentsanthropicclaudecursordebt-collectiondebt-recoveryfintechllmmcpmcp-servermodel-context-protocoltypescript

Captured live from the server via tools/list.

ping

Verify the connection to Debitura and show which creditor account the API key belongs to. Call this first to confirm the integration is set up correctly.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_cases

List the creditor's debt collection cases with pagination, status filtering, and sorting. Returns compact case summaries: reference, debtor name + country, amounts, lifecycle, partner, key dates. Use get_case for full detail on a specific case. Lifecycle values (statuses filter and output): `PendingContractSigning` · `PendingVerificationInternal` · `PendingVerification` · `NeedsAdditionalDetails` · `Leads` · `LeadsQuoteGiven` · `Active` · `Paused` · `Closed` · `Merged` Sortable fields: `DateCreated` · `DateUpdated` · `DateFinished` · `DateCollectionStarted` · `DueDate` · `Date` · `GrossAmount` · `Remainder` · `InterestFees` · `CollectionFees` Sort format: `Field:asc` or `Field:desc`, e.g. `GrossAmount:desc` Note: results include the creditor's own test cases; the `isTestCase` flag on each case marks them.

Parameters4

page	integer	optional	Page number, starting from 1 (default 1)
pageSize	integer	optional	Results per page (default 10, max 100)
statuses	array	optional	Filter by lifecycle status. Values: PendingContractSigning, PendingVerificationInternal, PendingVerification, NeedsAdditionalDetails, Leads, LeadsQuoteGiven, Active, Paused, Closed, Merged
sort	string	optional	Sort expression: Field:asc or Field:desc. Valid fields: DateCreated, DateUpdated, DateFinished, DateCollectionStarted, DueDate, Date, GrossAmount, Remainder, InterestFees, CollectionFees. Example: GrossAmount:desc

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number, starting from 1 (default 1)"
    },
    "pageSize": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Results per page (default 10, max 100)"
    },
    "statuses": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "PendingContractSigning",
          "PendingVerificationInternal",
          "PendingVerification",
          "NeedsAdditionalDetails",
          "Leads",
          "LeadsQuoteGiven",
          "Active",
          "Paused",
          "Closed",
          "Merged"
        ]
      },
      "description": "Filter by lifecycle status. Values: PendingContractSigning, PendingVerificationInternal, PendingVerification, NeedsAdditionalDetails, Leads, LeadsQuoteGiven, Active, Paused, Closed, Merged"
    },
    "sort": {
      "type": "string",
      "description": "Sort expression: Field:asc or Field:desc. Valid fields: DateCreated, DateUpdated, DateFinished, DateCollectionStarted, DueDate, Date, GrossAmount, Remainder, InterestFees, CollectionFees. Example: GrossAmount:desc"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_case

Fetch one collection case in full detail. Look it up by Debitura case ID (GUID), by your own creditor reference (e.g. invoice number), or by the Debitura case reference shown in the portal. Provide exactly one of the three identifiers.

Parameters3

id	string	optional	Debitura case ID (GUID)
creditorReference	string	optional	Your own reference for the case (e.g. invoice number)
caseReference	string	optional	Debitura case reference as shown in the portal

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "Debitura case ID (GUID)"
    },
    "creditorReference": {
      "type": "string",
      "description": "Your own reference for the case (e.g. invoice number)"
    },
    "caseReference": {
      "type": "string",
      "description": "Debitura case reference as shown in the portal"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_case_activity

Fetch the chronological timeline of a case — what has happened so far: status changes, partner actions, communications, and payments. Returns an envelope `{ items, currentEngagementPhase }`: `items` is the chronological event list, and `currentEngagementPhase` is the case's current engagement phase ("Pre-legal", "Legal", or "Enforcement"; null when no active engagement exists).

Parameters1

caseId

string

required

Debitura case ID (GUID)

Raw schema

{
  "type": "object",
  "properties": {
    "caseId": {
      "type": "string",
      "format": "uuid",
      "description": "Debitura case ID (GUID)"
    }
  },
  "required": [
    "caseId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_case_messages

Read the chat conversation on a case between you and the collection partner handling it. Each message includes: senderName, role (Creditor / Partner / Managed by partner), sentAt (UTC), message. See the debitura://glossary/chat-roles resource for what each role means.

Parameters1

caseId

string

required

Debitura case ID (GUID)

Raw schema

{
  "type": "object",
  "properties": {
    "caseId": {
      "type": "string",
      "format": "uuid",
      "description": "Debitura case ID (GUID)"
    }
  },
  "required": [
    "caseId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_case_payments

List every payment recorded on a case — money recovered so far.

Parameters1

caseId

string

required

Debitura case ID (GUID)

Raw schema

{
  "type": "object",
  "properties": {
    "caseId": {
      "type": "string",
      "format": "uuid",
      "description": "Debitura case ID (GUID)"
    }
  },
  "required": [
    "caseId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_case_contract_status

Check which contracts (e.g. debt collection agreement, power of attorney) are signed or still blocking a case, including signing URLs for any outstanding documents.

Parameters1

caseId

string

required

Debitura case ID (GUID)

Raw schema

{
  "type": "object",
  "properties": {
    "caseId": {
      "type": "string",
      "format": "uuid",
      "description": "Debitura case ID (GUID)"
    }
  },
  "required": [
    "caseId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_case

Dry-run a collection case BEFORE creating it: returns eligibility, the assigned collection partner, pricing (success fee), and any contracts that would need signing. Nothing is persisted. ALWAYS call this before create_case and show the user the pricing and requirements.

Parameters6

amountToRecover	number	required	Total principal amount to recover
currencyCode	string	required	ISO 4217 currency code, e.g. "EUR", "USD", "DKK"
debtorType	string	required	Company (B2B) or Private individual (B2C)
debtorCountryAlpha2	string	required	Debtor country, ISO 3166-1 alpha-2, e.g. "DE", "US"
debtorStateAlpha2	string	optional	US state code, e.g. "CA" — REQUIRED when the debtor is in the United States
dueDate	string	optional	Invoice due date (ISO 8601) — used to compute debt age for pricing

Raw schema

{
  "type": "object",
  "properties": {
    "amountToRecover": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Total principal amount to recover"
    },
    "currencyCode": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3,
      "description": "ISO 4217 currency code, e.g. \"EUR\", \"USD\", \"DKK\""
    },
    "debtorType": {
      "type": "string",
      "enum": [
        "Company",
        "Private"
      ],
      "description": "Company (B2B) or Private individual (B2C)"
    },
    "debtorCountryAlpha2": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Debtor country, ISO 3166-1 alpha-2, e.g. \"DE\", \"US\""
    },
    "debtorStateAlpha2": {
      "type": "string",
      "description": "US state code, e.g. \"CA\" — REQUIRED when the debtor is in the United States"
    },
    "dueDate": {
      "type": "string",
      "description": "Invoice due date (ISO 8601) — used to compute debt age for pricing"
    }
  },
  "required": [
    "amountToRecover",
    "currencyCode",
    "debtorType",
    "debtorCountryAlpha2"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_team_members

List the team members on the creditor's Debitura account. Use this to resolve a valid sender (userId or email) before calling send_case_message, or a case owner for create_case.

Parameters2

page	integer	optional	Page number (default 1)
pageSize	integer	optional	Results per page

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number (default 1)"
    },
    "pageSize": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Results per page"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_case_files

List all documents attached to a case: file name, document type, description, upload date, and a time-limited SAS download URL. Each file also carries downloadUrlExpiresAt (UTC) — when the download URL stops working, so a cached URL can be refreshed in time. Use upload_case_file to attach new documents.

Parameters1

caseId

string

required

Debitura case ID (GUID)

Raw schema

{
  "type": "object",
  "properties": {
    "caseId": {
      "type": "string",
      "format": "uuid",
      "description": "Debitura case ID (GUID)"
    }
  },
  "required": [
    "caseId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_account_summary

Return a count of cases per lifecycle stage for the creditor's account. Useful for a quick portfolio overview without listing all cases. Stages: PendingContractSigning, PendingVerificationInternal, PendingVerification, NeedsAdditionalDetails, Leads, LeadsQuoteGiven, Active, Paused, Closed, Merged. Note: these counts include the creditor's own test cases; list_cases exposes the `isTestCase` flag that marks them.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_tasks

List every open task (action-item) across your whole account — things the platform needs you to do before a case (or your account) can proceed: reply to a chat, sign a contract, assign a bank account, and so on. Use get_case_tasks instead to scope this to one case. Tasks auto-resolve once the underlying condition clears — e.g. replying to a case's chat makes its ReplyToChat task disappear on its own. Treat this as a live work queue, not a log: a task seen on one call may no longer be open on the next. Every task carries a solutionUrl — an absolute link a human can open to resolve it in one click, whatever the type. Some types (today: ReplyToChat, ClientInputRequired, MoreInfoNeeded) additionally carry a non-null `action` pointing at the exact API call that resolves them — for those, call send_case_message with the task's caseId instead of sending a human to solutionUrl. Tasks without an action rely on solutionUrl alone. Task types: Generic, ReplyToChat, SelectQuoteWinner, ReviewPartner, ClientInputRequired, SignContract, MoreInfoNeeded, AssignBankAccount, CaseValidationNeedsInfo.

Parameters4

status	string	optional	Filter by task status. "Open" (default) or "Solved".
type	array	optional	Restrict to specific task types, e.g. ["ReplyToChat", "SignContract"]. Valid values: Generic, ReplyToChat, SelectQuoteWinner, ReviewPartner, ClientInputRequired, SignContract, MoreInfoNeeded, AssignBankAccount, CaseValidationNeedsInfo
page	integer	optional	Page number, starting from 1 (default 1)
pageSize	integer	optional	Results per page (default 10, max 100)

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "Open",
        "Solved"
      ],
      "description": "Filter by task status. \"Open\" (default) or \"Solved\"."
    },
    "type": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Generic",
          "ReplyToChat",
          "SelectQuoteWinner",
          "ReviewPartner",
          "ClientInputRequired",
          "SignContract",
          "MoreInfoNeeded",
          "AssignBankAccount",
          "CaseValidationNeedsInfo"
        ]
      },
      "description": "Restrict to specific task types, e.g. [\"ReplyToChat\", \"SignContract\"]. Valid values: Generic, ReplyToChat, SelectQuoteWinner, ReviewPartner, ClientInputRequired, SignContract, MoreInfoNeeded, AssignBankAccount, CaseValidationNeedsInfo"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number, starting from 1 (default 1)"
    },
    "pageSize": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Results per page (default 10, max 100)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_case_tasks

List the open tasks (action-items) attached to one specific case — same data as list_tasks, scoped to a single case. Use this when you're already working a specific case and want just its outstanding tasks. Note: account-level tasks that aren't tied to any one case (e.g. SignContract, AssignBankAccount — these block the whole account, not one case) never appear here; use list_tasks to see those. See list_tasks for the full task model (auto-resolve, solutionUrl, action).

Parameters3

caseId	string	required	Debitura case ID (GUID)
status	string	optional	Filter by task status. "Open" (default) or "Solved".
type	array	optional	Restrict to specific task types, e.g. ["ReplyToChat", "SignContract"]. Valid values: Generic, ReplyToChat, SelectQuoteWinner, ReviewPartner, ClientInputRequired, SignContract, MoreInfoNeeded, AssignBankAccount, CaseValidationNeedsInfo

Raw schema

{
  "type": "object",
  "properties": {
    "caseId": {
      "type": "string",
      "format": "uuid",
      "description": "Debitura case ID (GUID)"
    },
    "status": {
      "type": "string",
      "enum": [
        "Open",
        "Solved"
      ],
      "description": "Filter by task status. \"Open\" (default) or \"Solved\"."
    },
    "type": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Generic",
          "ReplyToChat",
          "SelectQuoteWinner",
          "ReviewPartner",
          "ClientInputRequired",
          "SignContract",
          "MoreInfoNeeded",
          "AssignBankAccount",
          "CaseValidationNeedsInfo"
        ]
      },
      "description": "Restrict to specific task types, e.g. [\"ReplyToChat\", \"SignContract\"]. Valid values: Generic, ReplyToChat, SelectQuoteWinner, ReviewPartner, ClientInputRequired, SignContract, MoreInfoNeeded, AssignBankAccount, CaseValidationNeedsInfo"
    }
  },
  "required": [
    "caseId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_case

Submit a debt collection case to Debitura. This is a LEGAL AND FINANCIAL ACTION: a collection partner starts recovery against the debtor, and contractual fees apply on success. Required workflow — never skip it: 1. Call preview_case first and show the user the pricing, assigned partner, and any contracts that need signing. 2. Ask the user to explicitly confirm submission. 3. Only then call this tool. NEVER call it without the user's explicit confirmation in this conversation. Submission is idempotent: the server sends a unique Idempotency-Key and safely retries transient network failures without risk of duplicate cases. A 422 response is a business rejection — read its payload (it may contain signing URLs for required contracts, or duplicate-reference details).

Parameters12

amountToRecover	number	required	Total principal amount to recover
currencyCode	string	required	ISO 4217 currency code, e.g. "EUR"
debtor	object	required	The debtor the claim is against
date	string	required	Invoice date (ISO 8601, e.g. 2026-03-01) — required by the API
dueDate	string	required	Invoice due date (ISO 8601, e.g. 2026-04-30). Required — Debitura computes the age of the debt from it, which affects pricing.
claimDescription	string	optional	Description of the claim (what the debt is for)
comments	string	optional	Context for the collection partner, e.g. payment history or prior communication
creditorReference	string	optional	RECOMMENDED: your own reference (e.g. invoice number). Helps avoid business duplicates and lets you look the case up later.
assignedUserEmail	string	optional	Email of the team member to own the case (use list_team_members to find valid team members)
allowPendingContracts	boolean	optional	Accept the case even if contracts (SDCA/POA) are unsigned — it waits in PendingContractSigning with signing URLs returned
isTest	boolean	optional	Create as test data (persisted but excluded from production metrics)
tag	string	optional	Optional tag for grouping test data

Raw schema

{
  "type": "object",
  "properties": {
    "amountToRecover": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Total principal amount to recover"
    },
    "currencyCode": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3,
      "description": "ISO 4217 currency code, e.g. \"EUR\""
    },
    "debtor": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "Company",
            "Private"
          ],
          "description": "Company (B2B) or Private individual (B2C)"
        },
        "name": {
          "type": "string",
          "description": "Company name or person's full name"
        },
        "contactPerson": {
          "type": "string",
          "description": "Contact person (companies only)"
        },
        "companyRegistrationNumber": {
          "type": "string",
          "description": "Company registration number (VAT/CVR/org number)"
        },
        "address": {
          "type": "string",
          "description": "Street address — required by the API"
        },
        "zipCode": {
          "type": "string",
          "description": "Postal/ZIP code"
        },
        "city": {
          "type": "string",
          "description": "City — required by the API"
        },
        "countryAlpha2": {
          "type": "string",
          "minLength": 2,
          "maxLength": 2,
          "description": "Country (ISO 3166-1 alpha-2)"
        },
        "stateAlpha2": {
          "type": "string",
          "description": "US state code, e.g. \"CA\" — REQUIRED for United States debtors"
        },
        "email": {
          "type": "string",
          "description": "Debtor email"
        },
        "phone": {
          "type": "string",
          "description": "Debtor phone incl. country code"
        }
      },
      "required": [
        "type",
        "name",
        "address",
        "city",
        "countryAlpha2"
      ],
      "additionalProperties": false,
      "description": "The debtor the claim is against"
    },
    "date": {
      "type": "string",
      "description": "Invoice date (ISO 8601, e.g. 2026-03-01) — required by the API"
    },
    "dueDate": {
      "type": "string",
      "description": "Invoice due date (ISO 8601, e.g. 2026-04-30). Required — Debitura computes the age of the debt from it, which affects pricing."
    },
    "claimDescription": {
      "type": "string",
      "description": "Description of the claim (what the debt is for)"
    },
    "comments": {
      "type": "string",
      "description": "Context for the collection partner, e.g. payment history or prior communication"
    },
    "creditorReference": {
      "type": "string",
      "maxLength": 50,
      "description": "RECOMMENDED: your own reference (e.g. invoice number). Helps avoid business duplicates and lets you look the case up later."
    },
    "assignedUserEmail": {
      "type": "string",
      "description": "Email of the team member to own the case (use list_team_members to find valid team members)"
    },
    "allowPendingContracts": {
      "type": "boolean",
      "description": "Accept the case even if contracts (SDCA/POA) are unsigned — it waits in PendingContractSigning with signing URLs returned"
    },
    "isTest": {
      "type": "boolean",
      "description": "Create as test data (persisted but excluded from production metrics)"
    },
    "tag": {
      "type": "string",
      "description": "Optional tag for grouping test data"
    }
  },
  "required": [
    "amountToRecover",
    "currencyCode",
    "debtor",
    "date",
    "dueDate"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

upload_case_file

Attach a document to a case (invoice copy, contract, correspondence, proof of delivery). Max 25 MB. Allowed extensions: .pdf, .xls, .xlsx, .csv, .txt, .jpg, .jpeg, .png, .gif. Provide the file content base64-encoded.

Parameters6

caseId	string	required	Debitura case ID (GUID)
fileName	string	required	File name including extension, e.g. "invoice-1042.pdf"
contentBase64	string	required	File content, base64-encoded
contentType	string	optional	MIME type, e.g. "application/pdf" (inferred from extension if omitted)
description	string	optional	Short description of the document
documentType	string	optional	Document category (default: OriginalInvoice). Values: OriginalInvoice · DebtorDocuments · CreditorDocuments · PartnerDocuments · DemandLetter · Miscellaneous

Raw schema

{
  "type": "object",
  "properties": {
    "caseId": {
      "type": "string",
      "format": "uuid",
      "description": "Debitura case ID (GUID)"
    },
    "fileName": {
      "type": "string",
      "description": "File name including extension, e.g. \"invoice-1042.pdf\""
    },
    "contentBase64": {
      "type": "string",
      "description": "File content, base64-encoded"
    },
    "contentType": {
      "type": "string",
      "description": "MIME type, e.g. \"application/pdf\" (inferred from extension if omitted)"
    },
    "description": {
      "type": "string",
      "description": "Short description of the document"
    },
    "documentType": {
      "type": "string",
      "enum": [
        "OriginalInvoice",
        "DebtorDocuments",
        "CreditorDocuments",
        "PartnerDocuments",
        "DemandLetter",
        "Miscellaneous"
      ],
      "description": "Document category (default: OriginalInvoice). Values: OriginalInvoice · DebtorDocuments · CreditorDocuments · PartnerDocuments · DemandLetter · Miscellaneous"
    }
  },
  "required": [
    "caseId",
    "fileName",
    "contentBase64"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

send_case_message

Send a chat message on a case to the collection partner handling it. The partner is notified by email. The message is attributed to a named team member, so a sender is REQUIRED: pass the sender's userId or email from list_team_members. Ask the user who the message should be sent as if it is not obvious.

Parameters4

caseId	string	required	Debitura case ID (GUID)
message	string	required	The message to send
senderUserId	string	optional	Team member ID sending the message (from list_team_members)
senderEmail	string	optional	Team member email sending the message (alternative to senderUserId)

Raw schema

{
  "type": "object",
  "properties": {
    "caseId": {
      "type": "string",
      "format": "uuid",
      "description": "Debitura case ID (GUID)"
    },
    "message": {
      "type": "string",
      "minLength": 1,
      "description": "The message to send"
    },
    "senderUserId": {
      "type": "string",
      "format": "uuid",
      "description": "Team member ID sending the message (from list_team_members)"
    },
    "senderEmail": {
      "type": "string",
      "description": "Team member email sending the message (alternative to senderUserId)"
    }
  },
  "required": [
    "caseId",
    "message"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md11 KBView on GitHub

Debitura MCP Server

The MCP server for cross-border debt collection. Connect Claude, Cursor, VS Code, or any MCP-compatible agent to Debitura and manage international debt recovery from your AI assistant: check case status, read partner conversations, get pricing, and submit new collection cases — handled by vetted local collection partners in 183 countries on a no-cure-no-pay basis.

Endpoint: https://mcp.debitura.com/mcp (streamable HTTP)
Auth: your Debitura API key in the XApiKey header (or Authorization: Bearer <key>)
Get a key: log in at app.debitura.com → API key page
Connector page: debitura.com/integration/mcp-server

Tools

Read

Tool	What it does
`ping`	Test the connection — "✓ Connected as {your company}"
`list_cases`	List your collection cases (paging, status filter, sorting)
`get_case`	Fetch one case by ID, your own reference, or Debitura case reference
`get_case_activity`	Case timeline — what has happened so far (returns `{ items, currentEngagementPhase }`)
`get_case_messages`	Read the chat with the collection partner
`get_case_payments`	Money recovered on a case
`get_case_contract_status`	Which contracts are signed / blocking a case
`get_case_tasks`	Open tasks (action-items) for one case
`list_case_files`	List documents attached to a case, with time-limited download URLs
`get_account_summary`	Case counts per lifecycle stage — a quick portfolio overview
`list_tasks`	Every open task (action-item) across your account, with solutionUrl + resolving action
`preview_case`	Pricing + eligibility dry-run before submitting (nothing persisted)
`list_team_members`	Your team — used to attribute messages and assign case owners

Write

Tool	What it does
`create_case`	Submit a collection case. Instructs the assistant to preview first and get explicit user confirmation, then submits idempotently (auto `Idempotency-Key`, safe retries, no duplicate cases)
`upload_case_file`	Attach documents to a case (invoice copies, contracts — max 25 MB)
`send_case_message`	Message the collection partner on a case, attributed to a named team member

Every tool carries MCP annotations (readOnlyHint / destructiveHint); the write tools are marked destructive. create_case is a legal/financial action: its tool description tells the assistant to run preview_case and get the user's explicit confirmation before submitting. Whether your MCP client also asks before running a tool depends on the client and its settings.

Distribution

Debitura runs this MCP server as a hosted service at https://mcp.debitura.com/mcp. That is the only supported way to use it — point any MCP client at the endpoint and authenticate with your Debitura API key (see Install below). There is no published npm package: the @debitura/mcp-server package is private ("private": true) and is not distributed on the npm registry. The source is published so you can audit it and, if you wish, run your own copy (see Self-hosting / development) — but normal usage is the hosted endpoint.

Install

Claude (web / desktop)

Settings → Connectors → Add custom connector → URL https://mcp.debitura.com/mcp.

Anthropic is rolling out a Request headers option in that same dialog that lets you authenticate without OAuth — but it's a gated beta (Anthropic: "contact us for early access"), so most accounts won't see it yet. If you do see it, add header x-api-key with your Debitura API key as the value. If you don't, use Claude Code or the Claude Desktop config-file method below instead — both work today regardless of beta access.

Claude Code

bash

claude mcp add --transport http debitura https://mcp.debitura.com/mcp --header "XApiKey: YOUR_API_KEY"

Claude Desktop (no beta access to Request headers)

Bypass the Connectors UI entirely by editing claude_desktop_config.json directly — a separate mechanism from the web-synced Connectors UI, no OAuth involved — using the mcp-remote bridge:

json

{
  "mcpServers": {
    "debitura": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.debitura.com/mcp", "--header", "XApiKey:${DEBITURA_KEY}"],
      "env": { "DEBITURA_KEY": "YOUR_API_KEY" }
    }
  }
}

File location: macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json. Restart Claude Desktop after saving — the server appears under Settings → Connectors → Manage connectors, even though you never touched "Add custom connector".

Cursor

Add to ~/.cursor/mcp.json:

json

{
  "mcpServers": {
    "debitura": {
      "url": "https://mcp.debitura.com/mcp",
      "headers": { "XApiKey": "YOUR_API_KEY" }
    }
  }
}

VS Code (GitHub Copilot)

bash

code --add-mcp '{"name":"debitura","type":"http","url":"https://mcp.debitura.com/mcp","headers":{"XApiKey":"YOUR_API_KEY"}}'

Verify

Ask your assistant: "Ping Debitura" → you should see ✓ Connected as {your company}.

Example prompts

"What's the status of my Debitura cases? Anything that needs my attention?"
"What would it cost to collect a €12,000 B2B debt in Germany?"
"Any new messages from collection partners this week?"
"Submit a collection case against Acme GmbH in Berlin for invoice 2026-014, €8,400, due 1 March."

Security

Authentication & tenancy. The XApiKey header IS the tenant boundary. The server is stateless — each request creates a fresh MCP server bound to the caller's API key, which is passed straight through to the Debitura Customer API. No keys or case data are stored.
Transport. The hosted endpoint is served over HTTPS through Cloudflare.
Rate limits. Tool calls are forwarded to the Debitura Customer API, so the Customer API's rate limits apply to your API key. Some tools make several Customer API calls per invocation (e.g. get_account_summary queries one count per lifecycle stage), and each call counts.
Vulnerability reports: see SECURITY.md.

Self-hosting / development

The supported way to use Debitura's MCP is the hosted endpoint above. The steps below are for local development / auditing of this repository only.

bash

npm install
npm run dev          # starts on :3000, POST /mcp

Env var	Default	Purpose
`PORT`	`3000`	Listen port
`DEBITURA_API_BASE_URL`	`https://customer-api.debitura.com`	Point at `https://testcustomer-api.debitura.com` for the test environment

See .env.example for a starter env file.

bash

npm run build && npm start        # production-style local run
docker build -t debitura-mcp . && docker run -p 3000:3000 debitura-mcp

Deployment note: the hosted service deploys the built app as a zip to Azure App Service (see .github/workflows/deploy.yml) — it does not run the Docker image in production. The Dockerfile is provided for local/self-hosted use.

E2E tests

Runs every tool against the test environment (creates only tagged isTest cases and deletes them):

bash

DEBITURA_API_BASE_URL=https://testcustomer-api.debitura.com npm run dev   # terminal 1
DEBITURA_TEST_API_KEY=<test key> MCP_URL=http://localhost:3000/mcp npx tsx scripts/e2e.ts

Regenerating API types

Types and the HTTP client are generated from the Customer API's OpenAPI spec (openapi/customer-api.json) via openapi-typescript — the curated 16-tool layer on top is hand-written:

bash

npm run fetch:spec   # pull latest spec + regenerate src/generated/customer-api.d.ts

Releasing a new version

The version lives in package.json (config.ts and client.ts derive from it). When bumping it, also update server.json — its version field is independent and must match the published registry listing. (smithery.yaml has no version field; Smithery picks up the package version automatically.)

When adding or removing a tool, also update the tool catalog above and the tools/list assertion in scripts/e2e.ts (it asserts the exact registered tool set).

About Debitura

Debitura is a global debt collection platform covering 183 countries. Creditors submit overdue B2B and B2C claims; vetted local collection partners in the debtor's jurisdiction recover them, typically no-cure-no-pay. Learn more at debitura.com · API docs at docs.debitura.com.

Install

Tools (16)

pinglist_casesget_caseget_case_activityget_case_messagesget_case_paymentsget_case_contract_statuspreview_case

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.debitura.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.debitura.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Debitura MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

ping

list_cases

get_case

get_case_activity

get_case_messages

get_case_payments

get_case_contract_status

preview_case

list_team_members

list_case_files

get_account_summary

list_tasks

get_case_tasks

create_case

upload_case_file

send_case_message

Debitura MCP Server

Tools

Read

Write

Distribution

Install

Claude (web / desktop)

Claude Code

Claude Desktop (no beta access to Request headers)

Cursor

VS Code (GitHub Copilot)

Verify

Example prompts

Security

Self-hosting / development

E2E tests

Regenerating API types

Releasing a new version

About Debitura

Install

Remote endpoint

Related servers