PaidPilot Invoice Tools
Pay-per-call invoice tools: payment reminders, late fees, payment terms, timesheet to invoice.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"invoice-tools": {
"url": "https://api.paidpilot.io/mcp"
}
}
}リモートエンドポイント
https://api.paidpilot.io/mcpstreamable-httpできること
ツール一覧
ツール（6）
🟢pricing
Free. Return the price of every paid tool and of the HTTP invoice PDF route, the payment network (Base) and the receiving address. No input, no network request, no payment.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢validate_invoice(invoice)
Free. Validate an invoice JSON (the body for POST /v1/invoice.pdf, or the output of invoice_from_timesheet) and return computed subtotal, discount, tax and total, or a list of field errors. Same checks as the paid PDF route. Offline, no payment.
入力スキーマ
{
"type": "object",
"properties": {
"invoice": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Invoice object: from, to, number, issue_date, currency, line_items[{description, quantity, unit_price}], optional tax and discount"
}
},
"required": [
"invoice"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢payment_reminder_draft(tone, from_name, client_name, invoice_number, amount, ...)
Draft a payment reminder email for one unpaid invoice in a friendly, firm or final-notice tone. Returns a subject, plain-text body, days overdue and a suggested next step. Use late_fee_calc first if you want the fee amount quoted in the email. Draft only: nothing is sent. Pure calculation: no network request, nothing is sent or stored. Costs $0.01 USDC per call via x402 (payment goes in _meta["x402/payment"]); invalid input returns an error and is not charged.
入力スキーマ
{
"type": "object",
"properties": {
"tone": {
"type": "string",
"enum": [
"friendly",
"polite",
"firm",
"final"
],
"description": "\"friendly\" (alias \"polite\"), \"firm\", or \"final\""
},
"from_name": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Your name or business, used in the sign-off"
},
"client_name": {
"description": "Client's name for the greeting",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"invoice_number": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"amount": {
"description": "Amount due",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000
},
"currency": {
"default": "USD",
"description": "ISO-4217, default USD",
"type": "string"
},
"due_date": {
"description": "YYYY-MM-DD",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"as_of": {
"description": "Today's date for the days-overdue count, YYYY-MM-DD (default: today, UTC)",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"payment_link": {
"type": "string",
"maxLength": 500,
"format": "uri"
},
"late_fee_terms": {
"description": "Your agreed late-fee terms, e.g. \"1.5% per month\"; mentioned in the final notice only",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"final_deadline_days": {
"default": 7,
"description": "Final notice: days the client has to pay",
"type": "integer",
"minimum": 1,
"maximum": 60
}
},
"required": [
"tone",
"from_name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢late_fee_calc(amount, currency, due_date, as_of, grace_days, ...)
Calculate the late fee on one overdue invoice: flat fee, monthly % or annual %, simple or compounding, with optional grace days. Returns days late, the fee, the new total and a line to paste on the invoice. Use payment_terms_check instead to work out when an invoice is due. Not legal advice; it does not look up state caps. Pure calculation: no network request, nothing is sent or stored. Costs $0.01 USDC per call via x402 (payment goes in _meta["x402/payment"]); invalid input returns an error and is not charged.
入力スキーマ
{
"type": "object",
"properties": {
"amount": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000,
"description": "Unpaid invoice amount"
},
"currency": {
"default": "USD",
"description": "ISO-4217, default USD",
"type": "string"
},
"due_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Invoice due date, YYYY-MM-DD"
},
"as_of": {
"description": "Date paid, or the date to calculate to, YYYY-MM-DD (default: today, UTC)",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"grace_days": {
"default": 0,
"description": "Days after the due date before any fee applies",
"type": "integer",
"minimum": 0,
"maximum": 365
},
"fee_type": {
"type": "string",
"enum": [
"flat",
"monthly_percent",
"annual_percent"
],
"description": "flat = one fixed fee; monthly_percent e.g. 1.5; annual_percent e.g. 18"
},
"rate_percent": {
"description": "Rate for monthly_percent / annual_percent",
"type": "number",
"minimum": 0,
"maximum": 100
},
"compounding": {
"default": false,
"description": "false = simple interest (default); true = compounds (monthly: per 30 days; annual: daily)",
"type": "boolean"
},
"flat_fee": {
"description": "Flat fee; required for fee_type=flat, optional one-time add-on otherwise",
"type": "number",
"minimum": 0,
"maximum": 1000000
},
"state": {
"description": "US state (2-letter) for the legal note",
"type": "string"
}
},
"required": [
"amount",
"due_date",
"fee_type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢payment_terms_check(invoice_date, terms, amount, currency, as_of)
Work out the due date and status for payment terms such as Net 30, 2/10 Net 30, Due on receipt, EOM or Net 30 EOM. Returns the early-payment discount amount and deadline, the annualized cost of skipping the discount, and suggested reminder dates. Use late_fee_calc once the invoice is overdue. Pure calculation: no network request, nothing is sent or stored. Costs $0.01 USDC per call via x402 (payment goes in _meta["x402/payment"]); invalid input returns an error and is not charged.
入力スキーマ
{
"type": "object",
"properties": {
"invoice_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Invoice date, YYYY-MM-DD"
},
"terms": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Payment terms, e.g. \"Net 30\", \"2/10 Net 30\", \"Due on receipt\", \"EOM\", \"Net 30 EOM\""
},
"amount": {
"description": "Invoice total (optional; enables the discount math)",
"type": "number",
"minimum": 0,
"maximum": 1000000000
},
"currency": {
"default": "USD",
"description": "ISO-4217, default USD",
"type": "string"
},
"as_of": {
"description": "Date to compute status for, YYYY-MM-DD (default: today, UTC)",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"invoice_date",
"terms"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢invoice_from_timesheet(seller, buyer, invoice_number, issue_date, due_date, ...)
Turn time entries (hours x rate, with optional rounding, grouping by task and expenses) into a validated invoice JSON with totals, ready for POST /v1/invoice.pdf. Use validate_invoice (free) instead if you already have an invoice. Pure calculation: no network request, nothing is sent or stored. Costs $0.02 USDC per call via x402 (payment goes in _meta["x402/payment"]); invalid input returns an error and is not charged.
入力スキーマ
{
"type": "object",
"properties": {
"seller": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"address": {
"type": "string",
"maxLength": 400
},
"email": {
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"phone": {
"type": "string",
"maxLength": 40
},
"tax_id": {
"type": "string",
"maxLength": 60
}
},
"required": [
"name"
]
},
"buyer": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"address": {
"type": "string",
"maxLength": 400
},
"email": {
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"phone": {
"type": "string",
"maxLength": 40
},
"tax_id": {
"type": "string",
"maxLength": 60
}
},
"required": [
"name"
]
},
"invoice_number": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"issue_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"due_date": {
"description": "YYYY-MM-DD; or give terms instead",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"terms": {
"description": "e.g. \"Net 15\"; sets due_date from issue_date (early-pay discounts are not applied to the invoice)",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"currency": {
"default": "USD",
"type": "string"
},
"default_rate": {
"description": "Hourly rate for entries without their own rate",
"type": "number",
"minimum": 0,
"maximum": 1000000
},
"entries": {
"minItems": 1,
"maxItems": 500,
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 250
},
"hours": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000
},
"rate": {
"type": "number",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"description",
"hours"
],
"additionalProperties": false
}
},
"group_by": {
"default": "entry",
"description": "entry = one line per entry; description = merge entries with the same description and rate",
"type": "string",
"enum": [
"entry",
"description"
]
},
"rounding": {
"type": "object",
"properties": {
"increment_minutes": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 5
},
{
"type": "number",
"const": 6
},
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 15
},
{
"type": "number",
"const": 30
},
{
"type": "number",
"const": 60
}
],
"description": "Round each entry to this many minutes"
},
"mode": {
"default": "up",
"type": "string",
"enum": [
"up",
"nearest"
]
}
},
"required": [
"increment_minutes"
],
"additionalProperties": false
},
"expenses": {
"description": "Reimbursable expenses, one line each",
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 250
},
"amount": {
"type": "number",
"minimum": 0,
"maximum": 1000000000
}
},
"required": [
"description",
"amount"
],
"additionalProperties": false
}
},
"tax_rate": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"discount": {
"type": "number",
"minimum": 0,
"maximum": 1000000000
},
"notes": {
"type": "string",
"maxLength": 2000
},
"payment_instructions": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"seller",
"buyer",
"invoice_number",
"issue_date",
"entries"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}コミュニティ
エビデンス