Slipstack PDF
Generate invoice and receipt PDFs from JSON. Agent-callable document API with a free demo quota.
我该使用它吗
质量与安全性
发现(3)
- HIGH
- MEDIUM在 get_api_key 中
- LOW在 get_account_usage 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"pdf": {
"url": "https://slipstack.dev/api/mcp"
}
}
}远程端点
https://slipstack.dev/api/mcpstreamable-http它能做什么
工具清单
工具(7)
🟡create_invoice_pdf(data, options, api_key)
Generate a professional invoice PDF from structured JSON (parties, line items, tax, discount). Returns a download URL valid for 24 hours plus computed totals. No account needed for up to 10 documents/day; pass api_key or an Authorization header for plan quotas.
输入模式
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"from": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Legal or display name"
},
"address": {
"type": "string",
"description": "Postal address, newlines allowed"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"logoUrl": {
"type": "string",
"description": "HTTPS URL of a logo image (issuer only)"
},
"vatId": {
"type": "string",
"description": "VAT identifier, e.g. FR12345678901 (needed for e-invoices with VAT)"
},
"countryCode": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO 3166-1 alpha-2 country code, e.g. FR (required for e-invoices)"
},
"city": {
"type": "string",
"description": "City name (improves e-invoice address quality)"
},
"postalCode": {
"type": "string",
"description": "Postal code"
}
},
"required": [
"name"
],
"additionalProperties": false,
"description": "The party issuing the document"
},
"to": {
"type": "object",
"properties": {
"name": {
"$ref": "#/properties/data/properties/from/properties/name"
},
"address": {
"$ref": "#/properties/data/properties/from/properties/address"
},
"email": {
"$ref": "#/properties/data/properties/from/properties/email"
},
"phone": {
"$ref": "#/properties/data/properties/from/properties/phone"
},
"logoUrl": {
"$ref": "#/properties/data/properties/from/properties/logoUrl"
},
"vatId": {
"$ref": "#/properties/data/properties/from/properties/vatId"
},
"countryCode": {
"$ref": "#/properties/data/properties/from/properties/countryCode"
},
"city": {
"$ref": "#/properties/data/properties/from/properties/city"
},
"postalCode": {
"$ref": "#/properties/data/properties/from/properties/postalCode"
}
},
"required": [
"name"
],
"additionalProperties": false,
"description": "The party being billed"
},
"number": {
"type": "string",
"minLength": 1,
"description": "Document number, e.g. INV-2026-001"
},
"date": {
"type": "string",
"description": "Issue date, e.g. 2026-06-09"
},
"dueDate": {
"type": "string",
"description": "Payment due date (invoices)"
},
"currency": {
"type": "string",
"description": "ISO 4217 code, default USD"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1
},
"quantity": {
"type": "number",
"minimum": 0
},
"unitPrice": {
"type": "number",
"minimum": 0,
"description": "Price per unit in the document currency"
}
},
"required": [
"description",
"quantity",
"unitPrice"
],
"additionalProperties": false
},
"minItems": 1
},
"taxRate": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Tax percent applied after discount"
},
"discount": {
"type": "number",
"minimum": 0,
"description": "Absolute discount amount"
},
"notes": {
"type": "string"
},
"terms": {
"type": "string"
},
"accentColor": {
"type": "string",
"description": "Hex color for the template accent, e.g. #0ea5e9"
},
"paymentIban": {
"type": "string",
"description": "Payment IBAN for SEPA credit transfer (e-invoices)"
},
"paymentReference": {
"type": "string",
"description": "Remittance/payment reference (e-invoice BT-83)"
},
"buyerReference": {
"type": "string",
"description": "Buyer reference, e.g. a German Leitweg-ID (e-invoice BT-10; required by XRechnung)"
}
},
"required": [
"from",
"to",
"number",
"items"
],
"additionalProperties": false
},
"options": {
"type": "object",
"properties": {
"format": {
"type": "string",
"enum": [
"A4",
"LETTER"
]
}
},
"additionalProperties": false
},
"api_key": {
"type": "string",
"description": "Optional Slipstack API key (psk_...). With a key, usage bills against your plan quota. Without one, the shared demo quota applies (10 documents/day per IP). Get a key at https://slipstack.dev/pricing"
}
},
"required": [
"data"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_receipt_pdf(data, options, api_key)
Generate a payment receipt PDF from structured JSON. Same schema as invoices (use `number` for the receipt number). Returns a 24-hour download URL and computed totals.
输入模式
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"from": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Legal or display name"
},
"address": {
"type": "string",
"description": "Postal address, newlines allowed"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"logoUrl": {
"type": "string",
"description": "HTTPS URL of a logo image (issuer only)"
},
"vatId": {
"type": "string",
"description": "VAT identifier, e.g. FR12345678901 (needed for e-invoices with VAT)"
},
"countryCode": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO 3166-1 alpha-2 country code, e.g. FR (required for e-invoices)"
},
"city": {
"type": "string",
"description": "City name (improves e-invoice address quality)"
},
"postalCode": {
"type": "string",
"description": "Postal code"
}
},
"required": [
"name"
],
"additionalProperties": false,
"description": "The party issuing the document"
},
"to": {
"type": "object",
"properties": {
"name": {
"$ref": "#/properties/data/properties/from/properties/name"
},
"address": {
"$ref": "#/properties/data/properties/from/properties/address"
},
"email": {
"$ref": "#/properties/data/properties/from/properties/email"
},
"phone": {
"$ref": "#/properties/data/properties/from/properties/phone"
},
"logoUrl": {
"$ref": "#/properties/data/properties/from/properties/logoUrl"
},
"vatId": {
"$ref": "#/properties/data/properties/from/properties/vatId"
},
"countryCode": {
"$ref": "#/properties/data/properties/from/properties/countryCode"
},
"city": {
"$ref": "#/properties/data/properties/from/properties/city"
},
"postalCode": {
"$ref": "#/properties/data/properties/from/properties/postalCode"
}
},
"required": [
"name"
],
"additionalProperties": false,
"description": "The party being billed"
},
"number": {
"type": "string",
"minLength": 1,
"description": "Document number, e.g. INV-2026-001"
},
"date": {
"type": "string",
"description": "Issue date, e.g. 2026-06-09"
},
"dueDate": {
"type": "string",
"description": "Payment due date (invoices)"
},
"currency": {
"type": "string",
"description": "ISO 4217 code, default USD"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1
},
"quantity": {
"type": "number",
"minimum": 0
},
"unitPrice": {
"type": "number",
"minimum": 0,
"description": "Price per unit in the document currency"
}
},
"required": [
"description",
"quantity",
"unitPrice"
],
"additionalProperties": false
},
"minItems": 1
},
"taxRate": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Tax percent applied after discount"
},
"discount": {
"type": "number",
"minimum": 0,
"description": "Absolute discount amount"
},
"notes": {
"type": "string"
},
"terms": {
"type": "string"
},
"accentColor": {
"type": "string",
"description": "Hex color for the template accent, e.g. #0ea5e9"
},
"paymentIban": {
"type": "string",
"description": "Payment IBAN for SEPA credit transfer (e-invoices)"
},
"paymentReference": {
"type": "string",
"description": "Remittance/payment reference (e-invoice BT-83)"
},
"buyerReference": {
"type": "string",
"description": "Buyer reference, e.g. a German Leitweg-ID (e-invoice BT-10; required by XRechnung)"
}
},
"required": [
"from",
"to",
"number",
"items"
],
"additionalProperties": false
},
"options": {
"type": "object",
"properties": {
"format": {
"type": "string",
"enum": [
"A4",
"LETTER"
]
}
},
"additionalProperties": false
},
"api_key": {
"type": "string",
"description": "Optional Slipstack API key (psk_...). With a key, usage bills against your plan quota. Without one, the shared demo quota applies (10 documents/day per IP). Get a key at https://slipstack.dev/pricing"
}
},
"required": [
"data"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_einvoice_xml(data, options, api_key)
Generate an EN 16931 e-invoice as UN/CEFACT Cross-Industry Invoice (CII) XML — the format behind France's Factur-X and Germany's XRechnung mandates. Same JSON shape as create_invoice_pdf plus a few extra fields: from/to countryCode (required), from.vatId (required when taxRate > 0), optional paymentIban, paymentReference, buyerReference. Returns a 24-hour download URL for the XML plus computed totals. Validated against the official EN 16931 schematron in CI.
输入模式
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"from": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Legal or display name"
},
"address": {
"type": "string",
"description": "Postal address, newlines allowed"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"logoUrl": {
"type": "string",
"description": "HTTPS URL of a logo image (issuer only)"
},
"vatId": {
"type": "string",
"description": "VAT identifier, e.g. FR12345678901 (needed for e-invoices with VAT)"
},
"countryCode": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO 3166-1 alpha-2 country code, e.g. FR (required for e-invoices)"
},
"city": {
"type": "string",
"description": "City name (improves e-invoice address quality)"
},
"postalCode": {
"type": "string",
"description": "Postal code"
}
},
"required": [
"name"
],
"additionalProperties": false,
"description": "The party issuing the document"
},
"to": {
"type": "object",
"properties": {
"name": {
"$ref": "#/properties/data/properties/from/properties/name"
},
"address": {
"$ref": "#/properties/data/properties/from/properties/address"
},
"email": {
"$ref": "#/properties/data/properties/from/properties/email"
},
"phone": {
"$ref": "#/properties/data/properties/from/properties/phone"
},
"logoUrl": {
"$ref": "#/properties/data/properties/from/properties/logoUrl"
},
"vatId": {
"$ref": "#/properties/data/properties/from/properties/vatId"
},
"countryCode": {
"$ref": "#/properties/data/properties/from/properties/countryCode"
},
"city": {
"$ref": "#/properties/data/properties/from/properties/city"
},
"postalCode": {
"$ref": "#/properties/data/properties/from/properties/postalCode"
}
},
"required": [
"name"
],
"additionalProperties": false,
"description": "The party being billed"
},
"number": {
"type": "string",
"minLength": 1,
"description": "Document number, e.g. INV-2026-001"
},
"date": {
"type": "string",
"description": "Issue date, e.g. 2026-06-09"
},
"dueDate": {
"type": "string",
"description": "Payment due date (invoices)"
},
"currency": {
"type": "string",
"description": "ISO 4217 code, default USD"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1
},
"quantity": {
"type": "number",
"minimum": 0
},
"unitPrice": {
"type": "number",
"minimum": 0,
"description": "Price per unit in the document currency"
}
},
"required": [
"description",
"quantity",
"unitPrice"
],
"additionalProperties": false
},
"minItems": 1
},
"taxRate": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Tax percent applied after discount"
},
"discount": {
"type": "number",
"minimum": 0,
"description": "Absolute discount amount"
},
"notes": {
"type": "string"
},
"terms": {
"type": "string"
},
"accentColor": {
"type": "string",
"description": "Hex color for the template accent, e.g. #0ea5e9"
},
"paymentIban": {
"type": "string",
"description": "Payment IBAN for SEPA credit transfer (e-invoices)"
},
"paymentReference": {
"type": "string",
"description": "Remittance/payment reference (e-invoice BT-83)"
},
"buyerReference": {
"type": "string",
"description": "Buyer reference, e.g. a German Leitweg-ID (e-invoice BT-10; required by XRechnung)"
}
},
"required": [
"from",
"to",
"number",
"items"
],
"additionalProperties": false
},
"options": {
"type": "object",
"properties": {
"profile": {
"type": "string",
"enum": [
"facturx-basic",
"xrechnung"
],
"description": "EN 16931 guideline: facturx-basic (default, France/Factur-X) or xrechnung (Germany, XRechnung 3.0)"
}
},
"additionalProperties": false
},
"api_key": {
"type": "string",
"description": "Optional Slipstack API key (psk_...). With a key, usage bills against your plan quota. Without one, the shared demo quota applies (10 documents/day per IP). Get a key at https://slipstack.dev/pricing"
}
},
"required": [
"data"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢parse_einvoice(xml, api_key)
Parse EN 16931 e-invoice XML — UN/CEFACT CII (Factur-X, ZUGFeRD, XRechnung) or UBL Invoice/CreditNote (Peppol BIS) — into normalized invoice JSON: parties, line items, totals, VAT ids, payment details. Pass the XML document as a string.
输入模式
{
"type": "object",
"properties": {
"xml": {
"type": "string",
"minLength": 1,
"description": "The complete e-invoice XML document (CII or UBL)"
},
"api_key": {
"type": "string",
"description": "Optional Slipstack API key (psk_...). With a key, usage bills against your plan quota. Without one, the shared demo quota applies (10 documents/day per IP). Get a key at https://slipstack.dev/pricing"
}
},
"required": [
"xml"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_document_schema
Returns the JSON shape accepted by create_invoice_pdf / create_receipt_pdf / create_einvoice_xml, a complete example payload, and current plan limits. Call this first if you are unsure how to structure a document.
输入模式
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_api_key(email)
Issue a free Slipstack API key (50 documents/month) for an email address, returned directly in the response — no signup flow, no email verification step. Idempotent: the same email always gets the same key back. Use the key as api_key on other tools or as an Authorization: Bearer header. Paid plans (from $19/mo for 1000 documents): https://buy.stripe.com/eVqeVcaEa9xFdnudDeew80n
输入模式
{
"type": "object",
"properties": {
"email": {
"type": "string",
"minLength": 3,
"description": "Email address to associate with the key (used for account recovery and plan upgrades)"
}
},
"required": [
"email"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_account_usage(api_key)
Returns the current month's document usage, quota, and plan for a Slipstack API key. Requires api_key (or an Authorization: Bearer header).
输入模式
{
"type": "object",
"properties": {
"api_key": {
"type": "string",
"description": "Slipstack API key (psk_...). Optional if sent as a Bearer header."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}社区
证据