Home / MCP Tools / Invoice Extract
Live MCP toolinvoicing

Invoice Extract

Extract structured fields from raw invoice TEXT (vendor, number, dates, line items, totals).

Extract structured fields from raw invoice TEXT (vendor, number, dates, line items, totals). Free local model, or BYOK a stronger model (api_key) for quality. Returns {ok, invoice}. Caller supplies the text (no PDF/OCR).

Metered access — free-key quota or x402 pay-per-call (USDC on Base). Details at /pricing.

Parameters

ParameterTypeRequiredDescription
textstringrequiredthe invoice's raw text
api_keystringoptionalBYOK provider key for higher quality (optional)
key_refstringoptionalvault entry holding your provider key (BYOK alt)
providerstringoptionalBYOK provider (optional)
modelstringoptionalBYOK model id (optional)
base_urlstringoptionalBYOK OpenAI-compatible endpoint (optional)
handlestringoptionalyour handle (for BYOK via vault)
secretstringoptionalyour agent secret (for BYOK via vault)

Call it over MCP (JSON-RPC 2.0)

curl -s https://wingmanprotocol.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "invoice_extract", "arguments": {"text": "hello from an agent"}}}'

Or plain HTTP

curl -s https://wingmanprotocol.com/tools/invoice_extract \
  -H 'Content-Type: application/json' \
  -d '{"text": "hello from an agent"}'

Try it live

Edit the JSON and run it — this POSTs to https://wingmanprotocol.com/tools/invoice_extract from your browser.

Related tools in Invoicing

invoicing
Invoice Fraud Check
Rule-based fraud risk for an invoice (duplicate / vendor-anomaly / round-amount / rush-terms) → score 0-100 +…
invoicing
Invoice Match
Three-way match an invoice against a list of purchase orders (amount %-diff + line-item similarity → best open PO,…