Skip to content
Agentmart
Submit a tool

Elster MCP Server

Drive the German tax portal ELSTER via Puppeteer: submit UStVA, prepare EUER/ESt, sync inbox.

Connector by lukasschwarz · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 24
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/lukasschwarz-elster-mcp-server

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Drive the German tax portal ELSTER via Puppeteer: submit UStVA, prepare EUER/ESt, sync inbox.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
5 read · 8 write · 0 delete · 1 not yet classified
Secrets
1 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 14

Read from the source code; the running server may list different tools.

Read 5 · Look things up without changing anything.

  • elster_config_show
  • elster_kennziffern_list
  • elster_session_list
  • elster_session_status
  • elster_ustva_detect_reverse_charge

Write 8 · Create, change, send or run things.

  • elster_est_start
  • elster_eur_start
  • elster_login_test
  • elster_session_cancel
  • elster_sync_history
  • elster_sync_inbox
  • elster_ustva_confirm
  • elster_ustva_start

Not yet classified 1 · We could not tell from the name and description.

  • elster_ustva_generate_xml

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • ELSTER_PASSWORD

Other settings (environment variables or headers).

  • ELSTER_CITY
  • ELSTER_CONFIG_PATH
  • ELSTER_COUNTRY
  • ELSTER_EST_SKIP_EUR
  • ELSTER_FIRST_NAME
  • ELSTER_HEADLESS
  • ELSTER_HOUSE_NUMBER
  • ELSTER_NAME
  • ELSTER_PFX_PATH
  • ELSTER_STATE_CODE
  • ELSTER_STREET
  • ELSTER_TAX_NUMBER
Show 1 more settings
  • ELSTER_ZIP

Tools (14)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • elster_config_show

    Shows the currently loaded ELSTER configuration (with secrets redacted) so you can verify env vars / config.json were picked up.

  • elster_est_start

    Starts an ESt 1 A (Einkommensteuererklärung) form-prep session. Opens the form, fills taxpayer basics from config + any extra fields you provide (by ELSTER input id/name hint), runs Prüfung, then waits 30 min for you to review in the portal. NEVER submits.

  • elster_eur_start

    Starts an EÜR (Anlage Einnahmen-Überschuss-Rechnung) form-prep session. Fills the form up to Prüfung, then tries to "Speichern und Verlassen" so the draft survives in ELSTER. NEVER submits.

  • elster_kennziffern_list

    Returns the list of supported UStVA Kennziffern (codes 81, 86, 66 etc.) with descriptions and whether they are NET (base amount) or TAX (tax amount).

  • elster_login_test

    Verifies that the configured certificate + password can log into the ELSTER portal. Returns success and final URL or an error. Use this once before submitting anything.

  • elster_session_cancel

    Cancels a running session (closes the browser, marks status as CANCELLED).

  • elster_session_list

    Lists all currently tracked sessions (USTVA / EUR / EST / SYNC) with their status.

  • elster_session_status

    Returns the current status, progress log, and any screenshot path for a session started via elster_ustva_start / elster_eur_start / elster_est_start.

  • elster_sync_history

    Reads "Übermittelte Formulare" (transmission history) from ELSTER. Optionally downloads PDFs.

  • elster_sync_inbox

    Reads ELSTER inbox messages ("Posteingang"). Optionally downloads each message as PDF.

  • elster_ustva_confirm

    Confirms submission of a UStVA session that is in AWAITING_CONFIRM state. Triggers the final "Absenden" click. Returns the transmission ticket on success.

  • elster_ustva_detect_reverse_charge

    Tests whether a voucher would be detected as Reverse-Charge (§13b UStG) based on the configured supplier patterns. Returns matched supplier and region (EU / NON_EU), or null.

  • elster_ustva_generate_xml

    Generates an ELSTER UStVA XML snapshot for archiving. Does NOT submit (submission goes via elster_ustva_start). Useful for audit trails.

  • elster_ustva_start

    Starts a UStVA submission session. Opens a browser, logs in, fills the form, runs Prüfung, then PAUSES at AWAITING_CONFIRM. You must explicitly call elster_ustva_confirm to send. Returns a sessionId — poll status via elster_session_status.

Signals

Stars
24
Forks
2
Open issues
0
Contributors
2
Last commit
Jul 13, 2026 (3 months ago)
Last release
Jun 27, 2026 (4 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.lukasschwarz/elster-mcp-server
Version
0.1.0
Auth
API key
Packages
npm elster-mcp-server
License
MIT
Repository
github.com/lukasschwarz/elster-mcp-server
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Elster MCP Server. Agent Mart. https://agentmart.dev/connectors/lukasschwarz-elster-mcp-server (last updated 2026-10-24)