FrankKiFrankKiMCP
Sign inGet started
Hosted · streamable HTTP · worldwide

Physical Mail
for Developers

One endpoint gives your agent a printer, an envelope, and a postbox. It drafts the letter, gets an exact destination quote, waits for your approval unless you switch on autopilot, and tracks the dispatch. After approval, real paper is delivered worldwide where the destination policy and postal partner allow it.

$https://mcp.frankki.app

OAuth sign-in for Claude and ChatGPT  ·  Scoped API keys for scripts  ·  No subscription

Quick setup

Connected in one line

Claude, Claude Desktop and Claude Code sign in over OAuth: add the URL, choose "Sign in now", sign in or create your FrankKi account, and allow access. You only need a scoped API key for scripts and servers. Every physical dispatch needs your approval unless you switch on autopilot.

Connect FrankKi to your AI agent

Choose your app. The setup prompt stays visible in case your browser blocks the handoff.

Before you send the prompt
  1. In Claude, open Customize > Connectors.
  2. Click "+ Add", then "Add custom connector".
  3. Name it FrankKi, paste https://mcp.frankki.app as the URL and click "Continue".
  4. Keep the detected settings and click "Continue". Under Authentication choose "Sign in now", then click "Add".
  5. In the window that opens, sign in with your FrankKi account or create one. New accounts get a code by email, which you enter. If you have not signed the data processing agreement yet, you sign it here. Then allow access.
  6. Send the setup prompt below. Claude takes it from there.

On a Team or Enterprise plan an owner adds it once under Organization settings > Connectors ("Add", then Custom > Web). Everyone else clicks "Connect" on it under Customize > Connectors.

Claude opens with the setup prompt filled in. Add the connector first, then press Send.

Setup prompt
Connect FrankKi at https://mcp.frankki.app so we can send letters by post. Ask me before you connect or grant permissions. Then run the FrankKi connection check mcp_health to see what my account still needs, and walk me through the setup step by step. Take our sender details and brand from our website and ask me once before you save them. Copy 1 to 3 templates that fit my business and show me one preview. For steps only I can do, such as a top-up, give me the link. Without my approval you send nothing and pay for nothing. Never switch on autopilot yourself.
claude mcp add --transport http frankki https://mcp.frankki.app

# headless, with an API key
claude mcp add --transport http frankki https://mcp.frankki.app \
  --header "Authorization: Bearer ${FRANKKI_API_KEY}"
Then ask: "Quote a registered letter to Berlin, then draft it."
Server nameapp.frankki/lettersOur canonical MCP server identifier. Listed in the Official MCP Registry.
Discovery/.well-known/oauth-authorization-serverOAuth 2.1 with dynamic client registration. The Claude and ChatGPT connectors sign in through it.
For agentsmcp.frankki.app/llms.txtMachine-readable overview of the whole platform.
The whole loop

From draft to post, with a human check

Draft, quote, submit for approval. A human reviews the rendered letter, exact price and service before dispatch. The agent never touches a printer, never guesses a price, and cannot spend past the cap you set on the call.

Prices come from the server, never hardcoded
Destructive tools are annotated for the model
Every physical send needs your approval unless you switch on autopilot
A dryRun rehearsal is free: same checks, same price, nothing printed
agent · frankki mcp
How a send works

Draft, quote, approve, track

Composition is text-first. You hand over content and a recipient; FrankKi renders a correctly laid-out DIN 5008 document. After your approval, or after a 10-minute cancel window on autopilot, it prints, franks it, and hands it to the postal network.

01letter_create_draft

Compose

Plain text plus a recipient. Back comes a rendered preview, letterhead and signature applied.

02shipping_quote

Price

The exact, live cost for that destination and service level, before anything is committed.

03approval_submit

Approve

Creates the final preview, reserves the quoted cost and queues the letter for explicit human approval. Nothing is printed yet.

04order_status

Track

After approval: printed, posted, delivered where supported. A verified posting record is available where the selected service provides one.

Tool catalog

A scoped, honest tool set

Read tools return state and never cost money. Action tools are explicit about what they change. Your agent can gate on the annotation.

Full reference
ToolWhat it doesSide effect
address_validateCheck a recipient against destination-country postal rulesread
address_search_companyLook up a company's postal address by nameread
template_listBrowse reusable letter templatesread
letter_create_draftDraft a formatted letter from plain text, returns a previewdraft
shipping_quoteExact price for a destination before committingread
wallet_balanceRead the prepaid wallet balanceread
order_sendSubmit one physical send to the approval-controlled pipeline, honours maxCostEurosdestructive
order_send_batchSubmit a batch to the approval-controlled pipeline with merge fieldsdestructive
approval_submitQueue a rendered letter for explicit human approval; no paper is printed yetqueue
order_statusTrack a letter through printed, posted, deliveredread
wallet_topup_linkCreate a secure Stripe top-up linkpayment

Beyond the core flow: attachments, letterheads and signatures, sender profiles, send presets, scheduled sends, cancellation, posting receipts, client lookups, and GoBD or DATEV archive exports. The authoritative list is always what the server returns from tools/list.

Delivery tracking

You can see where the paper is

Every submitted send has a status your agent can poll. After approval it is printed, franked, posted, and delivered where the destination supports it. A verified order_einlieferungsbeleg can provide an archived proof-of-posting record. That records postal acceptance, not the legal effectiveness of the letter.

1–3working days inside Germany
DIN 5008layout by default
Worldwidewhere destination and carrier allow
order_statusord_2c7ad9f1Acme GmbH  ·  Berlin, DE  ·  standard b/w
delivered
Draft rendered1 page, DIN 5008, letterhead applied
09:14
Wallet reservedEUR 1.99 · under the EUR 5.00 cap
09:14
Human approvedPreview, exact price and service reviewed
09:16
Printed and frankedFulfillment centre, envelope sealed
11:02
Handed to the postal networkPosting receipt available
17:40
DeliveredTwo working days after the tool call
+2d
Guardrails

A rogue agent cannot mail the world

Sending paper is irreversible and it costs money, so the platform is cautious by default. Four independent limits, each of which alone stops a runaway loop.

Prepaid wallet

An empty wallet cannot spend

There are no post-paid invoices. Every paid send draws from a balance you topped up, so the absolute worst case is bounded by what is in the account.

Per-call cap

maxCostEuros aborts the send

Pass a ceiling with order_send. If the live server price exceeds it, nothing is printed and nothing is charged.

Human approval

Every physical dispatch needs approval

Every physical letter enters the approval queue. A human reviews the preview, exact price and service, then explicitly approves it through approval_decide before dispatch. If you switch on autopilot in the dashboard, letters from your released templates to known recipients go out after a 10-minute cancel window instead, within the daily and monthly limits you set. Rejection leaves the letter unprinted, and every decision is logged.

Key scopes

A pricing key need not be a spending key

Each API key carries an allowed-tools scope and its own spending limit, so the reach of a leaked key is decided in advance.

Test for free

Drafts, previews, quotes and a dryRun rehearsal cost nothing. A dryRun runs the same checks and pricing as a real send and returns page 1 as an image, with nothing printed and nothing charged. It needs the signed data processing agreement first. Money only moves when you approve a real letter.

Create an account
Wallet and pricing

EUR 1.99 a letter, down to EUR 1.59

If you send a few letters a month, a German standard letter in black and white is EUR 1.99. From 20 letters a month every letter that month is EUR 1.89, from 100 it is EUR 1.79, from 500 EUR 1.69, and from 1,000 letters EUR 1.59. The rung your volume reaches applies to every letter that month, including the first. Everything else is priced per destination and quoted live before the send. No subscription: top up from EUR 10 to EUR 500 per top-up through Stripe, and the balance does not expire. No company needed, freelancers and sole traders sign up too.

Never hardcode

Prices are authoritative from the server. Call shipping_quote for the live figure, always, before order_send.

ProductUnder 20 a monthDetail
Standard letterEUR 1.99Germany, black and white. Down to EUR 1.59 from 1,000 letters a month.
Standard letterEUR 2.09Germany, colour. Down to EUR 1.69 from 1,000 letters a month.
Registered, Einwurf (DE)EUR 5.99Germany, proof of posting, no signature. Down to EUR 5.59 from 1,000 letters a month.
Registered, Übergabe (DE)EUR 6.39Germany, handed over against signature. Down to EUR 5.99 from 1,000 letters a month.
Standard letter, black and white, by monthly volume
Under 20 letters a monthEUR 1.99
20 or moreEUR 1.89
100 or moreEUR 1.79
500 or moreEUR 1.69
1,000 or moreEUR 1.59

Measured on a trailing 30 days. The rung your volume reaches applies to every letter that month, including the first. Colour and registered products step down at the same five thresholds: EUR 2.09, EUR 5.99 and EUR 6.39 under 20 letters a month, EUR 1.69, EUR 5.59 and EUR 5.99 from 1,000.

Fixed prices for German products. Worldwide via local partners, quoted per destination. Top up the wallet through Stripe with wallet_topup_link.
Use cases

Workflows that dead-end at paper

Most automations stop at "now a human prints this and walks to a postbox". These are the ones that no longer have to.

Dunning

Queue a printed reminder from an email event, with the amount and due date merged per debtor.

Formal notices

Cancellations, terminations and objections where physical mail is appropriate, sent as registered mail where the destination supports it.

Onboarding

Welcome letters, contract confirmations and account notifications, triggered by your own backend events.

Compliance mail

Authority correspondence and regulated notices, archived with retrievable posting records where the selected service provides them.

Compliance

Built for regulated mail

Letter data is processed in the EU. FrankKi helps you draft, format and send physical letters, but it does not determine whether a letter is legally sufficient or effective. DIN 5008 describes layout, not legal effect. Posting records and delivery evidence are separate, and you remain responsible for content, recipient, authority, form, signature and deadlines. FrankKi provides no legal advice or individual legal assessment.

GoBDArchiving of sends and retrievable posting records where supported.
DATEV & DMSExports for accounting and document management systems.
GDPRLetter data processed in the EU, DSGVO by construction.
MandantenSeparated client matters, with approval flows before a letter leaves.
Hosted

Give your agent a postbox

Connect Claude and create your account in the sign-in window, or sign up first. Nothing to self-host, drafts and dryRun rehearsals are free, and every real dispatch needs your approval unless you switch on autopilot.

Get startedRead the docs
claude mcp add --transport http frankki https://mcp.frankki.app