Build invoice workflows humans can trust

MCP tools, REST endpoints, template schema, PDF generation, and text extraction. Agents can draft, validate, and automate invoices while humans keep approval control.

Quick start

1

Discover

curl https://freeinvoicemaker.app/.well-known/mcp.json
2

Read safely

curl -X POST https://freeinvoicemaker.app/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"templates.query","params":{}}'
3

Create with authorization

curl -X POST https://freeinvoicemaker.app/api/mcp \
  -H "Authorization: Bearer iv_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"invoices.create","params":{"...":"..."}}'

Authentication

MethodUse case
NonePublic discovery and safe template/schema reads.
Bearer API key (iv_...)Account-owned write tools. Get a key at /settings.
OAuth 2.1 + PKCEUser-facing agents acting with delegated user approval.
x402 USDCMetered automation for paid write or compute-heavy operations.

MCP tools (20)

Invoice lifecycle (8)

ToolAuthDescription
invoices.createKeyCreate a new invoice
invoices.queryNoneList and filter invoices
invoices.mutateKeyUpdate an existing invoice
invoices.exportNoExport to PDF, DOCX, CSV
invoices.sendKeySend invoice via email or link
invoices.finalizeKeyLock invoice, assign number
invoices.duplicateKeyClone an existing invoice
invoices.createFromDslKeyCreate from Invoice DSL string

AI-native (3)

ToolAuthDescription
invoices.summarizeNoNatural-language invoice summary
invoices.suggestKeySmart field suggestions from context
invoices.analyticsKeyRevenue analytics and trends

Templates and entities (5)

ToolAuthDescription
templates.queryNoneList available templates
templates.mutateKeyCreate or update custom templates
templates.applyKeyApply template to an invoice
entities.queryNoneList saved clients and businesses
entities.mutateKeyCreate or update entities

Platform (4)

ToolAuthDescription
importKeyImport from DOCX, Excel, CSV, PDF
invoices.automateKeySet up recurring invoices
iv.capabilitiesNoneList available features and limits
iv.feedbackNoSubmit feedback programmatically

Invoice DSL

The Invoice DSL is a compact text format for describing invoices. It uses ~100 tokens compared to ~400 for equivalent JSON, making it ideal for LLM-generated invoices.

INVOICE #INV-0042
FROM: Acme Corp | acme@example.com
TO: Globex Inc | globex@example.com
DATE: 2026-04-08
DUE: Net 30

Website redesign    | 1 | $4,200
Brand assets        | 1 | $1,800
Hosting (annual)    | 1 | $480

TAX: 10%
NOTE: Payment via wire transfer preferred.

Pass this string to invoices.createFromDsl to create a complete invoice in a single call.

Paid microservices (x402)

Some server endpoints use the x402 payment protocol with USDC on Base. These depend on configured providers; check the API documentation and verify availability before integrating. Browser PDF download is free.

ServicePriceDescription
OCR$0.005Extract text from invoice images
AI extract$0.01Structured data extraction from documents
Brand extract$0.01Logo, colors, fonts from a URL or image
PDF render$0.005Server-side PDF generation

Network: Base (USDC). Facilitator: x402.org.

Integration recipes

  • Draft, approve, send — agent drafts with invoices.create, a human reviews, then an authenticated workflow sends or exports the invoice
  • Import and extract — 2-call workflow: import (DOCX/CSV) → invoices.create
  • Chain with Zapier MCP Client — connect iv to 7,000+ apps via Zapier MCP Client
  • Chain with Stripe MCP — payment reconciliation via Stripe MCP Server
  • Chain with QuickBooks MCP — sync invoices via QuickBooks Online MCP Server

SDKs and tools

EndpointURLNotes
MCP/api/mcpJSON-RPC 2.0, full tool catalog
SSE streaming/api/mcp/streamServer-sent events for long-running ops
REST API/api/openapi.jsonOpenAPI 3.1 spec
WebMCP bridgewindow.postMessageFor browser-based agents

Rate limits

TierBurstSustainedDaily
Anonymous10/min60/hr200
Free30/min300/hr1,000
Pro120/min2,000/hr20,000
Team300/min5,000/hr50,000
Business600/min10,000/hr100,000

Resources