Pop MCP

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/popapidev-pop-mcp

About

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

6 read · 10 write · 0 delete

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (16)

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

• pop_create_ksef_invoiceCreate KSeF Invoice (FA(3) XML)

  Generate a Polish KSeF FA(3) XML invoice or credit note. The POP Cloud API performs the authoritative KSeF fiscal validation and can optionally submit the document through the configured KSeF provider integration. KSeF onboarding and legal-entity configuration must be completed for provider submission.

• pop_create_pdf_invoiceCreate PDF Invoice

  Generate a PDF invoice with optional branding and email delivery. Creates a printable PDF invoice. Can include company logo, custom footer, and billing/shipping addresses. The PDF can be emailed automatically to up to 3 recipients (Basic+ plan required for email). Configuration via data.pdf: - invoice_html: '"true"' to generate HTML version - doc_type_title: Title shown on document (e.g. 'Invoice', 'Receipt', 'Credit Note') - logo_url: Company logo URL (HTTPS) - head.store_info_address: Supplier address displayed in header - head.billing: Customer billing address array - email_in…

• pop_create_peppol_invoiceCreate Peppol / UBL Invoice

  Generate a Peppol e-invoice in UBL 2.1 format and optionally submit it to the Peppol network. Peppol (Pan-European Public Procurement Online) enables cross-border B2B electronic invoicing across Europe. The API generates a compliant UBL 2.1 XML document. Restrictions: - Customer type must be 'company' or 'freelance' (Peppol does not support private individuals) - Submission requires active Peppol via POP integration (Basic+ plan) - The customer must have a valid Peppol participant ID Returns: UBL XML string or JSON with UUID when submitting to the network. Args: - data: Complete invoice …

• pop_create_sdi_invoiceCreate SdI / FatturaPA Invoice (XML)

  Generate an Italian FatturaPA electronic invoice in XML format and optionally submit it to the SdI (Sistema di Interscambio). This tool creates a compliant FatturaPA XML document that satisfies Italian e-invoicing regulations (D.Lgs. 127/2015). The invoice can be generated locally (XML only) or submitted directly to SdI for B2B/B2C delivery. Key facts: - Supports invoice types: TD01 (invoice) and TD04 (credit note) - Customer types: private, company, freelance, pa (Public Administration) - For Private customers: sdi_type must be '0000000' and tax_id_code (codice fiscale) is required - For PA…

• pop_create_zugferd_invoiceCreate ZUGFeRD / Factur-X Invoice

  Generate a ZUGFeRD/Factur-X document package containing a visual PDF, EN16931 CII XML, and hybrid PDF with embedded XML. The POP Cloud API performs the authoritative document and fiscal validation and returns structured generation metadata.

• pop_get_invoice_statusGet SdI Invoice Statusread-only

  Retrieve the SdI processing status and notifications for a submitted invoice. After submitting an invoice to the Italian SdI (Sistema di Interscambio), the system processes it asynchronously and sends notifications. This tool polls the current status and all notifications. SdI notification statuses: - pending: Invoice received, awaiting processing - accepted: Invoice accepted and delivered to recipient - rejected: Invoice rejected (check details for reason and correction steps) - delivery: Delivery notification received Note: SdI processing can take from minutes to hours. If no noti…

• pop_get_peppol_documentGet Peppol Documentread-only

  Retrieve a Peppol document from the network by UUID. After a Peppol invoice is submitted, use this tool to retrieve the processed document or check its delivery status on the Peppol network. Args: - uuid: The Peppol document UUID from pop_create_peppol_invoice - zone: Country code for the Peppol access point (e.g. 'BE' for Belgium). Required for some regions. - response_format: Output format

• pop_get_sdi_documentGet SdI Documentread-only

  Retrieve an SdI document from POP storage by UUID. Fetches a previously submitted or preserved SdI (FatturaPA) document. Useful for auditing, re-downloading, or verifying stored invoices. Requires: Growth+ plan with active SdI via POP integration. Args: - uuid: The SdI document UUID - response_format: 'markdown' for readable summary, 'json' for raw data

• pop_onboarding_get_account_setupGet Account Setup Configurationread-only

  Retrieve the full account setup payload: current field values, lookup tables, capabilities, and integration state. This is step 4 of 5 in the onboarding sequence. Call this before save_account_setup to understand: - Which fields are already saved (non-null in configurations) - Which fields are locked (field_locks = true) and cannot be changed - Which integrations are available for the account country (capabilities) - Valid tax regime codes (lookup.tax_regimes keyed by country) - Valid Peppol scheme options (lookup.peppol.endpoint_scheme_options) - Which integration toggles can be set (allowed…

• pop_onboarding_get_statusGet Onboarding Statusread-only

  Retrieve the current onboarding state for the authenticated account. This is step 3 of 5 in the onboarding sequence (optional — use to poll state or check progress). Returns: state, next_action, wizard_variant, wizard_completed, required_fields, step_visibility, integration_state. Does NOT return configurations (field values). Use pop_onboarding_get_account_setup for those. Key behaviours: - auth_source will be 'onboarding_token' confirming the token was accepted. - step_visibility.integration = false means SdI/Peppol toggles do not apply to this account (basic variant). - integration_stat…

• pop_onboarding_request_otpRequest Onboarding OTP

  Start the POP onboarding flow by sending a one-time password (OTP) to an email address. This is step 1 of 5 in the onboarding sequence: request-otp → verify-otp → get_status → get_account_setup → save_account_setup Key behaviours: - The OTP code is returned directly in the response (not just by email). Read otp_code from the response. - OTP expires in 10 minutes. Pass it to pop_onboarding_verify_otp immediately. - If the email does not exist, a new POP account is created automatically. - For administrator accounts, no OTP is issued. Use the admin password as the otp field in verify-otp ins…

• pop_onboarding_save_account_setupSave Account Setup Configuration

  Save the account setup configuration and optionally activate SdI or Peppol integration. This is step 5 of 5 in the onboarding sequence. Integration rules: - To activate SdI (Italy/San Marino): set active_sdipop_integration=1 and active_peppol_integration=0 - To activate Peppol (EU countries): set active_peppol_integration=1 and active_sdipop_integration=0, and provide all peppol_* fields - SdI and Peppol are mutually exclusive — never set both to 1 - For 'basic' variant accounts (non-IT, non-EU): do not send integration toggle fields Key behaviours: - general_store_vat_number must be unique…

• pop_onboarding_verify_otpVerify Onboarding OTP

  Verify the OTP from pop_onboarding_request_otp and obtain an onboarding token. This is step 2 of 5 in the onboarding sequence. Key behaviours: - Returns an onboarding_token (48-character string). Save it — required for all subsequent steps. - Token expires 30 minutes after issue. No refresh endpoint; restart from request-otp if expired. - token_issued_at and token_expires_at are ISO 8601 strings (e.g. 2026-05-26T13:47:15+00:00). - wizard_variant is 'basic' if no country is saved yet — it updates after save_account_setup sets the country. - If wizard_required is false after this step, the acc…

• pop_preserve_documentPreserve / Archive SdI Document

  Archive an SdI document in long-term digital storage (conservazione sostitutiva). Italian law requires electronic invoices to be preserved for 10 years. This tool archives a document in POP's certified digital storage system to meet legal preservation requirements. IMPORTANT: Only call this tool when pop_get_invoice_status returns a status of RC (Ricevuta di Consegna — successfully delivered) or MC (Mancata Consegna — delivery failed but SdI accepted). Do NOT call for other statuses such as NS, EC, SE, or DT. Requires: Basic+ plan with active SdI via POP integration. Args: - uuid: UUID o…

• pop_sync_zoho_documentSync Invoice to Zoho

  Synchronize an invoice or credit note with the account's native Zoho Books/Invoice connector. The connector status is checked first by default. TD04 credit notes require a reference in connected_invoice_data, and the POP Cloud API performs the authoritative Zoho payload validation and mapping.

Signals

Stars

0

Forks

0

Open issues

1

Weekly downloads

18

Last commit

Sep 21, 2026 (1 month ago)

Last release

Jun 16, 2026 (4 months ago)

Last package publish

Jul 20, 2026 (3 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.popapidev/pop-mcp

Version

1.1.0

Auth

No auth

Packages

npm @getpopapi/pop-mcp

License

MIT

Repository

github.com/getpopapi/pop-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql