# scribo [Health: Active] **Category:** ๐Ÿ’ป Developer Tools **Repository:** https://github.com/causa-prima-ai/scribo-mcp **GitHub Stars:** 7 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/scribo ## Description EN 16931-compliant e-invoices: XRechnung, ZUGFeRD, Factur-X, Peppol BIS, Facturae or US PDF. Free. ## Claude Desktop Quick Installation Heuristic fallback โ€” verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low): ```json "mcpServers": { "scribo": { "command": "npx", "args": ["-y","scribo"] } } ``` ## Documentation & README A3 _ MCP server # Scribo MCP Server > Free, AI-native e-invoicing โ€” for any MCP client. ## Contents - [What is Scribo?](#what-is-scribo) - [What is the Scribo MCP server?](#what-is-the-scribo-mcp-server) - [Demo](#demo) - [Getting started](#getting-started) - [Quickstart](#quickstart) - [Setup & prerequisites](#setup--prerequisites) - [Usage](#usage) - [How it works](#how-it-works) - [Examples](#examples) - [Compliance](#compliance) - [FAQ](#faq) - [Resources](#resources) - [License](#license) ## What is Scribo? Scribo is a free, conversational e-invoicing tool. Describe an invoice in plain language โ€” "bill Acme GmbH โ‚ฌ2,400 for May design work" โ€” and it drafts a structured invoice for you to review, download and send directly. Just ask your AI agent about Scribo: it ships as an MCP server, a CLI, and a Claude/Codex skill, alongside a public HTTP API and a web app. Free forever โ€” no credit card. You just need a sender email. **Built by Causa Prima** โ€” Scribo is built by [**Causa Prima**](https://causaprima.ai/), a company building agentic AI for the CFO office. It's our first freely available skill โ€” an early glimpse of what we're building. ## What is the Scribo MCP server? The Scribo MCP server gives your AI assistant the ability to create invoices for you. It's a hosted [Model Context Protocol](https://modelcontextprotocol.io) endpoint โ€” add its URL to your assistant once, then just ask for an invoice and it gathers the details and hands back a finished, compliant invoice in the chat, ready to download and send. Because it's hosted, there's nothing to install or run locally. It works with any MCP-aware client โ€” **Claude Desktop, Claude.ai, Cursor, Cline, ChatGPT App, the OpenAI Codex CLI**, and others. Free, no signup โ€” your email is all you need. ### Demo https://github.com/user-attachments/assets/3e1fcca8-580b-448f-bb1c-bee5ee016b54 ## Getting started ### Quickstart Scribo's MCP server is hosted โ€” there's nothing to install. Point your client at: ``` https://scribo.causaprima.ai/mcp ``` In **Claude Desktop or Claude.ai**: **Customize โ†’ Connectors โ†’ Add custom connector**, name it `Scribo`, paste the URL, and save. Then just ask: > Draft an invoice for 3 days of consulting at โ‚ฌ1,200/day to Acme GmbH. Scribo collects the missing details, verifies your sender email once, and returns a download link. Using a different client? See the per-client setup below. ### Setup & prerequisites The server speaks MCP over **Streamable HTTP** (JSON-RPC 2.0, MCP spec โ‰ฅ 2025-03-26) with **no auth**. Any MCP-aware client connects with one setting โ€” the URL `https://scribo.causaprima.ai/mcp`. **Claude Desktop / Claude.ai** โ€” Customize โ†’ Connectors โ†’ Add custom connector โ†’ name `Scribo`, paste the URL. On Team/Enterprise plans an org owner may need to add it once under Organization settings โ†’ Connectors. **Cursor** โ€” add to `~/.cursor/mcp.json` (or workspace `.cursor/mcp.json`): ```json { "mcpServers": { "scribo": { "url": "https://scribo.causaprima.ai/mcp" } } } ``` **Cline** โ€” add to `cline_mcp_settings.json`: ```json { "mcpServers": { "scribo": { "transport": "streamable-http", "url": "https://scribo.causaprima.ai/mcp" } } } ``` **OpenAI Codex CLI** โ€” add to `~/.codex/config.toml`, then restart Codex: ```toml [mcp_servers.scribo] url = "https://scribo.causaprima.ai/mcp" ``` **Any other MCP client** โ€” configure a remote server at the URL above, transport Streamable HTTP, no auth. > Prefer a plain-bash setup with no connector in the loop? The [Scribo skill](https://github.com/causa-prima-ai/scribo-skill) covers Claude Code, Claude.ai, Claude Desktop, and Codex via simple helper scripts. **Verify.** Ask your assistant: _"list the jurisdictions Scribo supports."_ ## Usage ### How it works You describe the invoice in plain language; your assistant calls Scribo's tools to build it. The server exposes four tools: | Tool | What it does | |---|---| | `create_invoice` | Generates a compliant invoice from the sender, recipient, and line-item details, and returns a durable download link. | | `verify_email_code` | Confirms ownership of the sender email using the 6-digit code Scribo emails on the first invoice. | | `get_invoice` | Re-fetches a previously generated invoice and a fresh download link. | | `list_supported_jurisdictions` | Lists which countries and formats are available. | A typical flow: you ask for an invoice โ†’ your assistant calls `create_invoice` and collects anything missing โ†’ on your first invoice from a new sender email, Scribo asks you to paste a 6-digit code (confirmed via `verify_email_code`) โ†’ your assistant retries and hands back a download link โ€” a PDF with the matching EN 16931 XML embedded. On clients that render widgets (e.g. the ChatGPT App), the invoice appears as a card with a download button. The server also registers five workflow **prompts** (`generate_invoice`, `german_b2b_invoice`, `german_b2g_xrechnung`, `us_plain_pdf_invoice`, `redownload_invoice`) โ€” clients that surface prompts show them as slash-command-style starters. Full tool schemas and sample payloads are in [`schemas/`](https://github.com/causa-prima-ai/scribo-mcp/blob/HEAD/schemas) and [`examples/`](https://github.com/causa-prima-ai/scribo-mcp/blob/HEAD/examples), and in the [MCP docs](https://scribo.causaprima.ai/docs/mcp). ### Examples Things you can say to your assistant once Scribo is connected: **German B2B invoice (ZUGFeRD)** > Invoice Beispiel GmbH for 12 hours of web development at โ‚ฌ110/hour, 19% VAT. I'm Example GmbH, VAT ID DE123456789. Returns a ZUGFeRD invoice โ€” a PDF a human can read, with EN 16931 XML embedded for the recipient's accounting system. **German public-sector invoice (XRechnung)** > Same client, but it's for the City of Munich โ€” the Leitweg-ID is 04011000-1234512345-06. A Leitweg-ID tells Scribo this is a B2G invoice, so it produces XRechnung, the format German public authorities require. **US invoice (plain PDF)** > Bill Acme Inc. $4,000 for a brand strategy workshop. A clean PDF invoice โ€” no e-invoice XML, since the US has no e-invoicing mandate. **Re-download a past invoice** > Send me the download link for the invoice I made for Beispiel GmbH last week. Scribo returns a fresh download link for an invoice you've already generated. ## Compliance Scribo emits invoices conforming to **EN 16931**, the European e-invoicing standard, with the relevant national CIUS. Every EN 16931 output (ZUGFeRD, XRechnung) is validated against the **Invopop**-hosted validator at generate-time โ€” output that fails the rule set never reaches the user. US plain PDFs carry no EN 16931 XML and are rendered directly. **Supported formats** | Jurisdiction | Format | Status | |---|---|---| | Germany (B2B) | **ZUGFeRD** COMFORT (PDF/A-3 hybrid + CII XML) | โœ… Live | | Germany (B2G) | **XRechnung** (UBL / CII) | โœ… Live | | United States | Plain PDF (no XML, no e-invoice claim) | โœ… Live | | France | **Factur-X** EN 16931 | ๐Ÿ”œ Coming soon | | Spain | **Facturae** | ๐Ÿ”œ Coming soon | | Belgium / NL / LU / AT | **Peppol BIS 3.0** UBL | ๐Ÿ”œ Coming soon | *Disclaimer: Scribo generates and validates compliant invoice documents. It is **not tax or legal advice** โ€” Scribo does not determine your tax obligations, VAT treatment, or filing requirements.* ## FAQ
Is Scribo really free? Yes โ€” free forever. No credit card, no subscription, no paywall before your first invoice. You just need a sender email.
Do I need an account or signup? No signup form. On your first invoice, Scribo verifies the sender email โ€” a 6-digit code (or one-click link) arrives at that address; one verification covers ~30 minutes of invoicing. The same email doubles as your magic-link login for re-downloads later.
Which countries and formats are supported? Live today: **Germany** โ€” ZUGFeRD (B2B) and XRechnung (B2G) โ€” and the **United States** (plain PDF). Coming next: **France** (Factur-X), **Spain** (Facturae), and **Belgium / NL / LU / AT** (Peppol BIS 3.0).
What does "EN 16931-compliant" actually mean here? Every EN 16931 output (ZUGFeRD, XRechnung) is validated against the **EN 16931-1:2017** rule set (via the Invopop-hosted validator) before it's returned. Output that fails validation never reaches you. US plain PDFs carry no EN 16931 XML, so no schematron validation applies.
Is the US version compliant? Yes. There is no US e-invoicing mandate, so Scribo produces a fully compliant plain PDF.
Does Scribo give tax or legal advice? No. Scribo generates and validates compliant invoice *documents*. It does not determine your tax obligations, VAT treatment, or filing requirements.
How do AI agents / LLMs use Scribo? Scribo is built to be operated by an agent. It ships as an **MCP server**, a **CLI**, and a **Claude/Codex skill**, plus a public **HTTP API** and a **web app** โ€” all on the same backend. An agent can discover Scribo, create an invoice, and return the file on a user's behalf.
Who builds Scribo? [Causa Prima](https://causaprima.ai/) โ€” a company building agentic AI for the CFO office. Operated by Causa Prima Germany GmbH, Munich.
## Resources - **Web app** โ€” [scribo.causaprima.ai](https://scribo.causaprima.ai) - **Documentation** โ€” [scribo.causaprima.ai/docs](https://scribo.causaprima.ai/docs) - **Compliance & trust** โ€” [scribo.causaprima.ai/compliance](https://scribo.causaprima.ai/compliance) - **Causa Prima** โ€” [causaprima.ai](https://causaprima.ai) **Other Scribo surfaces** - Skill (Claude / Codex) โ€” [`scribo-skill`](https://github.com/causa-prima-ai/scribo-skill) ยท [docs](https://scribo.causaprima.ai/docs/skill) - MCP server โ€” [`scribo-mcp`](https://github.com/causa-prima-ai/scribo-mcp) ยท [docs](https://scribo.causaprima.ai/docs/mcp) - CLI โ€” [`scribo-cli`](https://github.com/causa-prima-ai/scribo-cli) ยท [docs](https://scribo.causaprima.ai/docs/cli) - HTTP API โ€” [`scribo-api-docs`](https://github.com/causa-prima-ai/scribo-api-docs) ยท [docs](https://scribo.causaprima.ai/docs/api) - Brand hub โ€” [`scribo`](https://github.com/causa-prima-ai/scribo) ## License Proprietary โ€” `UNLICENSED`. ยฉ Causa Prima Germany GmbH. All rights reserved. Distributed for use against the public Scribo API; not open-source. See [LICENSE](https://github.com/causa-prima-ai/scribo-mcp/blob/HEAD/LICENSE).