debitura/Debitura.MCP

**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 )
- **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.