Skip to main content
Glama
scantobill-mcp-server
by nooot77

ScanToBill MCP Server


What is this?

ScanToBill is an AI-powered OCR platform for Arabic and English business documents — invoices, receipts, contracts, and IDs. This package connects ScanToBill to Claude Desktop (or any MCP-compatible AI client) so you can extract invoice data just by sharing a URL with Claude.

You: "Extract the line items from this invoice: https://example.com/invoice.pdf"

Claude: Here's what I found:
  - Consulting services: SAR 5,000
  - VAT (15%): SAR 750
  - Total: SAR 5,750

  Vendor: Al-Noor Trading Co.
  Date: 2026-07-15
  Invoice #: INV-2026-0042

Related MCP server: Mistral OCR MCP Server

Quick start

npx @scantobill/mcp-server --api-key ocr_sk_YOUR_KEY

Get a free API key at app.scantobill.com/keys — 20 extractions/month, no credit card.


Claude Desktop setup

1. Open the config file

OS

Path

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

2. Add this entry

{
  "mcpServers": {
    "scantobill": {
      "command": "npx",
      "args": ["-y", "@scantobill/mcp-server", "--api-key", "ocr_sk_YOUR_KEY"]
    }
  }
}

3. Restart Claude Desktop — done.


Available tools

Tool

Description

extract_document

Extract structured JSON from an invoice, receipt, or business document at a public URL

list_extractions

List past extractions with optional date, type, and status filters

get_extraction

Fetch full metadata for a specific extraction by ID

extract_document

url            (required) Public URL — PDF, JPG, PNG, or TIFF
document_type  invoice · receipt · contract · id  (default: invoice)
language       ar · en · auto  (default: auto)

list_extractions

limit    Number of results (default: 10, max: 50)
status   pending · processing · done · failed
from     ISO 8601 start date
to       ISO 8601 end date

get_extraction

id    (required) Extraction ID returned by extract_document

Authentication

# CLI flag
npx @scantobill/mcp-server --api-key ocr_sk_YOUR_KEY

# Environment variable
SCANTOBILL_API_KEY=ocr_sk_YOUR_KEY npx @scantobill/mcp-server

Supported documents

Type

Arabic

English

Mixed

Invoice (فاتورة)

✅

✅

✅

Receipt (إيصال)

✅

✅

✅

Contract (عقد)

✅

✅

✅

National ID

✅

✅

—

VAT invoice (ZATCA)

✅

—

—


Pricing

Plan

Extractions/month

Price

Free

20

$0

Starter

500

$15

Pro

5,000

$49

Enterprise

Unlimited

Custom


License

MIT © ScanToBill

Available Tools

3 tools
extract_documentA

Extract structured data from an invoice, receipt, commercial register, VAT certificate, or other business document at a public URL. Returns JSON with all detected fields including vendor, customer, line items, totals, VAT, and currency. Each extraction consumes one unit from the authenticated user's plan quota.

Inputs: document_url (required), language, document_type.

get_extractionA

Get the metadata for a specific past extraction by its log ID. Returns the document type, OCR provider used, status, and timestamp.

Inputs: extraction_id (required).

list_extractionsA

List past extraction log entries for the authenticated user. Returns extraction metadata (ID, type, provider, date, status) sorted newest first. Use get_extraction for the full details of a specific entry.

Inputs: limit, to_date, from_date, document_type.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: extracting a new document, listing past extractions, and fetching a specific extraction's metadata. No overlap or ambiguity exists.

    Naming Consistency5/5

    All tool names follow the same verb_noun pattern with lowercase and underscores: get_extraction, extract_document, list_extractions. Consistent and predictable.

    Tool Count4/5

    Three tools is slightly minimal but appropriate for a focused extraction service. Each tool serves a distinct need in the extraction workflow, though additional operations like delete or re-extract could be added.

    Completeness4/5

    The set covers the core lifecycle: create (extract_document), list (list_extractions), and get (get_extraction). Missing update/delete operations, but extractions are likely immutable, so this is acceptable. A tool to check quota would be a minor addition.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers