Krajowy System e-Faktur (KSeF) MCP server

Connect Krajowy System e-Faktur (KSeF) to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Krajowy System e-Faktur (KSeF) MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list session invoices tool in Krajowy System e-Faktur (KSeF)
  • Use the close session tool in Krajowy System e-Faktur (KSeF)
  • Use the submit invoice tool in Krajowy System e-Faktur (KSeF)
  • Use the download invoice upo tool in Krajowy System e-Faktur (KSeF)
  • Use the get session status tool in Krajowy System e-Faktur (KSeF)
  • Use the download session upo tool in Krajowy System e-Faktur (KSeF)

Supported Tools

list_session_invoices

List Session Invoices

List submitted invoices in a KSeF session with their references, hashes, KSeF numbers, and processing results. Use the continuation token to fetch the next page.

close_session

Close Session

Close an online invoice submission session by its reference number, including a session left open after a failed automatic close. This starts generation of the session receipt; check session status to track processing and receipt readiness.

submit_invoice

Submit Invoice

Submit one complete FA(3) XML invoice for processing in KSeF. This action is irreversible. Acceptance starts processing and does not mean that a KSeF number has been issued.

download_invoice_upo

Download Invoice UPO

Download the official receipt for an accepted invoice in a KSeF session.

get_session_status

Get Session Status

Check an invoice submission session for its current processing status, invoice counts, and available session UPO pages.

download_session_upo

Download Session UPO

Download a generated XML receipt page for an invoice submission session.

list_sessions

List Sessions

List online invoice submission sessions. Filter by reference, dates, or status, then use the continuation token to retrieve more results.

get_connection_status

Get Connection Status

Verify KSeF access and return the configured environment, authenticated context, and current effective context limits.

get_invoice_status

Get Invoice Status

Check a submitted invoice by its session and invoice references. Return its processing result, KSeF number, duplicate origin, and receipt readiness.

search_invoices

Search Invoices

Search KSeF invoice metadata by party role, date range, identifiers, amounts, and document type.

download_invoice

Download Invoice

Download the original XML invoice identified by its KSeF number.

Connect Krajowy System e-Faktur (KSeF) to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Krajowy System e-Faktur (KSeF) in Metorial. In your Metorial portal, enable the Krajowy System e-Faktur (KSeF) MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Krajowy System e-Faktur (KSeF) tools.

Run Krajowy System e-Faktur (KSeF) through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Krajowy System e-Faktur (KSeF) and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Krajowy System e-Faktur (KSeF) tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Krajowy System e-Faktur (KSeF)

Metorial Search

Search the web and fetch readable content from selected pages. Built for fast discovery and content extraction.

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Technical notes for Krajowy System e-Faktur (KSeF)

Search and download invoices from Poland's National e-Invoice System (KSeF), submit FA(3) XML invoices, inspect online submission sessions, and download official UPO receipts.

Frequently asked questions

Common questions about connecting Krajowy System e-Faktur (KSeF) to AI agents with Metorial.

  1. How many tools does the Krajowy System e-Faktur (KSeF) MCP server have?
    The Krajowy System e-Faktur (KSeF) MCP server exposes 11 tools, including List Session Invoices, Close Session, Submit Invoice. Each one is governed and traced through Metorial.
  2. Krajowy System e-Faktur (KSeF) exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Krajowy System e-Faktur (KSeF) MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Krajowy System e-Faktur (KSeF) and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Krajowy System e-Faktur (KSeF) MCP server yourself or use the hosted gateway.

Connect Krajowy System e-Faktur (KSeF) to production AI agents

See how Metorial gives your team governed access to Krajowy System e-Faktur (KSeF), with tracing and security controls built in.