{
  "markdown": "<img width=\"3840\" height=\"1920\" alt=\"A3 _ MCP server\" src=\"https://github.com/user-attachments/assets/21e2cf1e-69c0-414c-9cee-180a60c17f51\" />\n\n# Scribo MCP Server\n\n> Free, AI-native e-invoicing — for any MCP client.\n\n## Contents\n\n- [What is Scribo?](#what-is-scribo)\n- [What is the Scribo MCP server?](#what-is-the-scribo-mcp-server)\n  - [Demo](#demo)\n- [Getting started](#getting-started)\n  - [Quickstart](#quickstart)\n  - [Setup & prerequisites](#setup--prerequisites)\n- [Usage](#usage)\n  - [How it works](#how-it-works)\n  - [Examples](#examples)\n- [Compliance](#compliance)\n- [FAQ](#faq)\n- [Resources](#resources)\n- [License](#license)\n\n## What is Scribo?\n\nScribo 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.\n\nJust 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.\n\n**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.\n\n## What is the Scribo MCP server?\n\nThe 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.\n\nBecause 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.\n\n### Demo\n\nhttps://github.com/user-attachments/assets/3e1fcca8-580b-448f-bb1c-bee5ee016b54\n\n## Getting started\n\n### Quickstart\n\nScribo's MCP server is hosted — there's nothing to install. Point your client at:\n\n```\nhttps://scribo.causaprima.ai/mcp\n```\n\nIn **Claude Desktop or Claude.ai**: **Customize → Connectors → Add custom connector**, name it `Scribo`, paste the URL, and save. Then just ask:\n\n> Draft an invoice for 3 days of consulting at €1,200/day to Acme GmbH.\n\nScribo collects the missing details, verifies your sender email once, and returns a download link.\n\nUsing a different client? See the per-client setup below.\n\n### Setup & prerequisites\n\nThe 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`.\n\n**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.\n\n**Cursor** — add to `~/.cursor/mcp.json` (or workspace `.cursor/mcp.json`):\n\n```json\n{ \"mcpServers\": { \"scribo\": { \"url\": \"https://scribo.causaprima.ai/mcp\" } } }\n```\n\n**Cline** — add to `cline_mcp_settings.json`:\n\n```json\n{ \"mcpServers\": { \"scribo\": { \"transport\": \"streamable-http\", \"url\": \"https://scribo.causaprima.ai/mcp\" } } }\n```\n\n**OpenAI Codex CLI** — add to `~/.codex/config.toml`, then restart Codex:\n\n```toml\n[mcp_servers.scribo]\nurl = \"https://scribo.causaprima.ai/mcp\"\n```\n\n**Any other MCP client** — configure a remote server at the URL above, transport Streamable HTTP, no auth.\n\n> 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.\n\n**Verify.** Ask your assistant: _\"list the jurisdictions Scribo supports.\"_\n\n## Usage\n\n### How it works\n\nYou describe the invoice in plain language; your assistant calls Scribo's tools to build it. The server exposes four tools:\n\n| Tool | What it does |\n|---|---|\n| `create_invoice` | Generates a compliant invoice from the sender, recipient, and line-item details, and returns a durable download link. |\n| `verify_email_code` | Confirms ownership of the sender email using the 6-digit code Scribo emails on the first invoice. |\n| `get_invoice` | Re-fetches a previously generated invoice and a fresh download link. |\n| `list_supported_jurisdictions` | Lists which countries and formats are available. |\n\nA 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.\n\nThe 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.\n\nFull tool schemas and sample payloads are in [`schemas/`](./schemas) and [`examples/`](./examples), and in the [MCP docs](https://scribo.causaprima.ai/docs/mcp).\n\n### Examples\n\nThings you can say to your assistant once Scribo is connected:\n\n**German B2B invoice (ZUGFeRD)**\n\n> Invoice Beispiel GmbH for 12 hours of web development at €110/hour, 19% VAT. I'm Example GmbH, VAT ID DE123456789.\n\nReturns a ZUGFeRD invoice — a PDF a human can read, with EN 16931 XML embedded for the recipient's accounting system.\n\n**German public-sector invoice (XRechnung)**\n\n> Same client, but it's for the City of Munich — the Leitweg-ID is 04011000-1234512345-06.\n\nA Leitweg-ID tells Scribo this is a B2G invoice, so it produces XRechnung, the format German public authorities require.\n\n**US invoice (plain PDF)**\n\n> Bill Acme Inc. $4,000 for a brand strategy workshop.\n\nA clean PDF invoice — no e-invoice XML, since the US has no e-invoicing mandate.\n\n**Re-download a past invoice**\n\n> Send me the download link for the invoice I made for Beispiel GmbH last week.\n\nScribo returns a fresh download link for an invoice you've already generated.\n\n## Compliance\n\nScribo 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.\n\n**Supported formats**\n\n| Jurisdiction | Format | Status |\n|---|---|---|\n| Germany (B2B) | **ZUGFeRD** COMFORT (PDF/A-3 hybrid + CII XML) | ✅ Live |\n| Germany (B2G) | **XRechnung** (UBL / CII) | ✅ Live |\n| United States | Plain PDF (no XML, no e-invoice claim) | ✅ Live |\n| France | **Factur-X** EN 16931 | 🔜 Coming soon |\n| Spain | **Facturae** | 🔜 Coming soon |\n| Belgium / NL / LU / AT | **Peppol BIS 3.0** UBL | 🔜 Coming soon |\n\n*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.*\n\n## FAQ\n\n<details>\n<summary><strong>Is Scribo really free?</strong></summary>\n\nYes — free forever. No credit card, no subscription, no paywall before your first invoice. You just need a sender email.\n\n</details>\n\n<details>\n<summary><strong>Do I need an account or signup?</strong></summary>\n\nNo 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.\n\n</details>\n\n<details>\n<summary><strong>Which countries and formats are supported?</strong></summary>\n\nLive 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).\n\n</details>\n\n<details>\n<summary><strong>What does \"EN 16931-compliant\" actually mean here?</strong></summary>\n\nEvery 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.\n\n</details>\n\n<details>\n<summary><strong>Is the US version compliant?</strong></summary>\n\nYes. There is no US e-invoicing mandate, so Scribo produces a fully compliant plain PDF.\n\n</details>\n\n<details>\n<summary><strong>Does Scribo give tax or legal advice?</strong></summary>\n\nNo. Scribo generates and validates compliant invoice *documents*. It does not determine your tax obligations, VAT treatment, or filing requirements.\n\n</details>\n\n<details>\n<summary><strong>How do AI agents / LLMs use Scribo?</strong></summary>\n\nScribo 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.\n\n</details>\n\n<details>\n<summary><strong>Who builds Scribo?</strong></summary>\n\n[Causa Prima](https://causaprima.ai/) — a company building agentic AI for the CFO office. Operated by Causa Prima Germany GmbH, Munich.\n\n</details>\n\n## Resources\n\n- **Web app** — [scribo.causaprima.ai](https://scribo.causaprima.ai)\n- **Documentation** — [scribo.causaprima.ai/docs](https://scribo.causaprima.ai/docs)\n- **Compliance & trust** — [scribo.causaprima.ai/compliance](https://scribo.causaprima.ai/compliance)\n- **Causa Prima** — [causaprima.ai](https://causaprima.ai)\n\n**Other Scribo surfaces**\n\n- Skill (Claude / Codex) — [`scribo-skill`](https://github.com/causa-prima-ai/scribo-skill) · [docs](https://scribo.causaprima.ai/docs/skill)\n- MCP server — [`scribo-mcp`](https://github.com/causa-prima-ai/scribo-mcp) · [docs](https://scribo.causaprima.ai/docs/mcp)\n- CLI — [`scribo-cli`](https://github.com/causa-prima-ai/scribo-cli) · [docs](https://scribo.causaprima.ai/docs/cli)\n- HTTP API — [`scribo-api-docs`](https://github.com/causa-prima-ai/scribo-api-docs) · [docs](https://scribo.causaprima.ai/docs/api)\n- Brand hub — [`scribo`](https://github.com/causa-prima-ai/scribo)\n\n## License\n\nProprietary — `UNLICENSED`. © Causa Prima Germany GmbH. All rights reserved. Distributed for use against the public Scribo API; not open-source. See [LICENSE](./LICENSE).\n\n",
  "bytes": 10725,
  "sha": "a3777b0beb828f28b76f5e429337f37b09e0440f290215a2ba4d0e487bf0d666",
  "repo_slug": "causa-prima-ai/scribo-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_causa_prima_ai_scribo_4e8b208d/readme"
}