Koskamo

theluckystrike MCP Deposits

A community MCP server for tracking client security and retainer deposits. It allows agents to record deposits, apply partial or full amounts to invoices as payments, process refunds, and generate balance statements or reports for clients.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

theluckystrike MCP Deposits logo, by theluckystrikeCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by theluckystrike
MCP endpoint (Streamable HTTP)
https://mcp.zovo.one/mcp/deposits
Vendor documentation

What its tools do

11 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (5)

Can change data (6)

11 of 11 have a description · 11 of 11 declare behavior hints · 10 of 10 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Record a security or retainer deposit received from a client
  • Apply part of a held deposit to an invoice as a payment
  • Refund part or all of a held deposit back to the client
  • Generate a plain-text or PDF statement of deposit movements

Source and maintenance

Community listingRegistry 0.23.0
mcp-registry: io.github.theluckystrike/deposits@0.23.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
mcp-deposits 0.22.6
MCP protocol negotiated in check
2025-11-25
Tools
11 advertised
Resources
2 advertised
Resource templates
0 advertised
Prompts
2 advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  },
  "prompts": {
    "listChanged": true
  },
  "resources": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Client deposit and retainer tracking. It covers security or retainer deposits received, applying part of a held deposit to an invoice as a payment in the invoice server, refunds, balances held per client and currency, deposit statements as plain text or A4 PDF, and deposits held for a long time. Amounts are minor units and are never added across currencies. Records are stored per user account on McpStamp's hosted service. The free tier has a monthly deposit limit; PDF statements and the whole-book view need Pro. One lifetime key unlocks this server and all 58 others: https://mcp.zovo.one/buy/bundle?src=instr.deposits

Tools

11 advertised

deposit_record — Record a deposit received
Advertised by the server during the last successful anonymous check.

Record a security or retainer deposit received from a client, in minor units, with its currency, the date it arrived and the bank reference. Returns the DEP-YYYY-NNNN id.

deposit_record input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "client",
    "amount_minor",
    "kind"
  ],
  "properties": {
    "kind": {
      "enum": [
        "security",
        "retainer"
      ],
      "type": "string",
      "description": "security: held against damage or non-payment. retainer: held against work not yet invoiced"
    },
    "notes": {
      "type": "string",
      "maxLength": 10000,
      "description": "Free text kept on the record and printed on the statement"
    },
    "client": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Client name or client id. A name the invoice server already knows brings its address, email and VAT id onto the deposit"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Defaults to your business default currency"
    },
    "reference": {
      "type": "string",
      "maxLength": 200,
      "description": "Bank reference, transfer note or cheque number the money arrived with"
    },
    "amount_minor": {
      "type": "integer",
      "maximum": 1000000000000,
      "description": "What was received, in MINOR units: 50000 = 500.00 EUR, 50000 = JPY 50000. Never a decimal",
      "exclusiveMinimum": 0
    },
    "client_email": {
      "type": "string",
      "maxLength": 320,
      "description": "Only if the user gave it; otherwise the stored client's email is used"
    },
    "client_vat_id": {
      "type": "string",
      "maxLength": 64,
      "description": "Client VAT / tax registration id"
    },
    "received_date": {
      "type": "string",
      "description": "YYYY-MM-DD, the day the money arrived. Defaults to today"
    },
    "client_address": {
      "type": "string",
      "maxLength": 2000,
      "description": "Postal address for the statement's client block, newlines allowed"
    }
  }
}
deposit_record annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
deposit_list — List deposits
Advertised by the server during the last successful anonymous check.
Advertised read-only

List deposits newest first: DEP number, client, kind, date, reference and what was received, applied, refunded and still held, with the same four totalled per currency. Filter by client, status, kind, date.

deposit_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "YYYY-MM-DD, latest received date"
    },
    "from": {
      "type": "string",
      "description": "YYYY-MM-DD, earliest received date"
    },
    "kind": {
      "enum": [
        "security",
        "retainer",
        "all"
      ],
      "type": "string",
      "description": "Default \"all\""
    },
    "client": {
      "type": "string",
      "description": "Only deposits for this client id, exact name, or a name containing this text"
    },
    "status": {
      "enum": [
        "held",
        "applied",
        "refunded",
        "all"
      ],
      "type": "string",
      "description": "Default \"all\". held means some of the money is still held"
    }
  }
}
deposit_list annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
deposit_apply — Apply a deposit to an invoice
Advertised by the server during the last successful anonymous check.

Apply part of a held deposit to one invoice: it records that amount as a PAYMENT through the invoice server. amount_minor defaults to the lesser of held and owed. More than either, or a pre-arrival date, is refused.

deposit_apply input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "invoice"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Deposit id such as DEP-2026-0001, or an exact client name"
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD, the day the deposit was set against the invoice. Defaults to today"
    },
    "note": {
      "type": "string",
      "maxLength": 10000,
      "description": "Free text kept on the application row"
    },
    "invoice": {
      "type": "string",
      "minLength": 1,
      "description": "The invoice number to apply it to, e.g. INV-2026-0001"
    },
    "amount_minor": {
      "type": "integer",
      "maximum": 1000000000000,
      "description": "How much of the deposit to apply, in minor units. Defaults to the smaller of what is held and what the invoice still owes",
      "exclusiveMinimum": 0
    }
  }
}
deposit_apply annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
deposit_refund — Refund a deposit
Advertised by the server during the last successful anonymous check.

Give part or all of a held deposit back to the client, with the date and how it was sent. Refuses more than is still held. The invoice server is not touched: a refund is not a payment.

deposit_refund input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Deposit id such as DEP-2026-0001, or an exact client name"
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD, the day the money went back. Defaults to today"
    },
    "note": {
      "type": "string",
      "maxLength": 10000,
      "description": "Free text kept on the refund row"
    },
    "method": {
      "type": "string",
      "maxLength": 200,
      "description": "How it was sent, e.g. \"bank transfer to the account it came from\". Printed on the statement"
    },
    "amount_minor": {
      "type": "integer",
      "maximum": 1000000000000,
      "description": "How much to give back, in minor units. Defaults to everything still held",
      "exclusiveMinimum": 0
    }
  }
}
deposit_refund annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
deposit_delete — Delete a deposit recorded by mistake
Advertised by the server during the last successful anonymous check.
Advertised destructive

Delete a deposit that never moved money, freeing that month's free-tier slot. One with anything applied or refunded is refused, naming it, since a payment or refund would be left with nothing behind it.

deposit_delete input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Deposit id such as DEP-2026-0001, or an exact client name"
    }
  }
}
deposit_delete annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": true
}
deposit_balance — What is held for a client
Advertised by the server during the last successful anonymous check.

Answer "how much of theirs am I holding?" for one client or everyone: received, applied to invoices, refunded and still held, one row per currency, never added across them. Reads only; deposit_list shows each deposit.

deposit_balance input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "as_of": {
      "type": "string",
      "description": "YYYY-MM-DD, count only deposits received on or before this day"
    },
    "client": {
      "type": "string",
      "description": "Client id, exact name or a name containing this text. Leave out for every client"
    }
  }
}
deposit_balance annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
deposit_statement_text — Plain-text deposit statement
Advertised by the server during the last successful anonymous check.
Advertised read-only

Turn one client's deposits into a plain-text statement to paste into an email: every movement in date order and the closing balance held. Pass currency when they have more than one. Also a .txt download link valid one hour. Free on every tier.

deposit_statement_text input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "client"
  ],
  "properties": {
    "as_of": {
      "type": "string",
      "description": "YYYY-MM-DD printed as the statement date. Defaults to today"
    },
    "client": {
      "type": "string",
      "minLength": 1,
      "description": "Client id, exact name or a name containing this text"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Only needed when the client has deposits in more than one currency"
    },
    "greeting": {
      "type": "string",
      "description": "Opening line, default \"Hello\" plus the client name"
    },
    "sign_off": {
      "type": "string",
      "description": "Closing line, default your business name from the shared profile"
    }
  }
}
deposit_statement_text annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
deposit_statement_pdf — Render the deposit statement as a PDF
Advertised by the server during the last successful anonymous check.
Advertised read-only

Call this tool to render one client's A4 deposit statement and return a download link valid for one hour. Titled DEPOSIT STATEMENT, every movement in date order, closing with what is still held. Pro.

deposit_statement_pdf input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "client"
  ],
  "properties": {
    "as_of": {
      "type": "string",
      "description": "YYYY-MM-DD printed as the statement date. Defaults to today"
    },
    "client": {
      "type": "string",
      "minLength": 1,
      "description": "Client id, exact name or a name containing this text"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Only needed when the client has deposits in more than one currency"
    },
    "out_path": {
      "type": "string",
      "description": "Name for the downloaded file, e.g. acme-deposits. Defaults to the client and currency; the statement comes back as a download link valid for one hour"
    }
  }
}
deposit_statement_pdf annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
deposits_report — What is held, and for how long
Advertised by the server during the last successful anonymous check.
Advertised read-only

The deposit book at a date: held per currency, received, applied and refunded, the oldest holdings with days held, and every deposit older than N days with nothing applied. Pro; deposit_balance is free.

deposits_report input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "as_of": {
      "type": "string",
      "description": "YYYY-MM-DD to count from. Defaults to today"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "How many oldest held deposits to list. Default 10"
    },
    "older_than_days": {
      "type": "integer",
      "maximum": 36500,
      "minimum": 0,
      "description": "Flag deposits received this many days ago or more with nothing applied. Default 90"
    }
  }
}
deposits_report annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
license_status — License status
Advertised by the server during the last successful anonymous check.
Advertised read-only

Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.

license_status input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
license_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
license_activate — Activate license
Advertised by the server during the last successful anonymous check.

Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.

license_activate input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "License key from checkout, MCPL1.<payload>.<signature>"
    }
  }
}
license_activate annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

2 advertised

upgrade_to_pro — Explain the upgrade

Advertised by the server during the last successful anonymous check.

Explain what Pro on the deposits server costs and exactly what the user has to do, without leaving the conversation.

feature
The capped feature that prompted this, if there was one
settle_deposits — Settle the deposits that are due back

Advertised by the server during the last successful anonymous check.

Review what is still held, then decide what to apply to an open invoice and what to refund.

No arguments advertised.

Resources

2 advertised

pricing — Pricing and upgrade

Advertised by the server during the last successful anonymous check.

What deposits costs, what Pro unlocks, the checkout link that carries this connection's token, and the one step a person has to take. Machine-readable; read it before telling a user how to lift a free-tier cap.

pricing URI
pricing://deposits

MIME type: application/json

held-deposits — Held deposits

Advertised by the server during the last successful anonymous check.

Every deposit with money still held, as JSON.

held-deposits URI
deposits://held

MIME type: application/json

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
445 ms
95th percentile latency
445 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 445 ms · metadata changed · 11 tool(s), 2 resource(s), 0 resource template(s), 2 prompt(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http mcp-deposits https://mcp.zovo.one/mcp/deposits

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add mcp-deposits --url https://mcp.zovo.one/mcp/deposits

Cursor

Merge this server into .cursor/mcp.json in your project, then enable mcp-deposits in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "mcp-deposits": {
      "url": "https://mcp.zovo.one/mcp/deposits"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "mcp-deposits": {
      "type": "streamableHttp",
      "url": "https://mcp.zovo.one/mcp/deposits",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start mcp-deposits and inspect its tools.
VS Code configuration
{
  "servers": {
    "mcp-deposits": {
      "type": "http",
      "url": "https://mcp.zovo.one/mcp/deposits"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http mcp-deposits https://mcp.zovo.one/mcp/deposits

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://mcp.zovo.one/mcp/deposits

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "mcp-deposits": {
      "serverUrl": "https://mcp.zovo.one/mcp/deposits"
    }
  }
}

Let your agent find its tools

Find servers like theluckystrike MCP Deposits from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 1,148