# POP MCP Server

POP MCP Server exposes POP document workflows and business integrations as a remote Model Context Protocol endpoint.

## Public pages

- Landing page: https://mcp.popapi.io/
- MCP server overview: https://mcp.popapi.io/mcp-server/
- Connect guide: https://mcp.popapi.io/connect/
- Tools guide: https://mcp.popapi.io/tools/
- Onboarding guide: https://mcp.popapi.io/onboarding/

## Endpoints

- MCP endpoint: https://mcp.popapi.io/mcp
- Health check: https://mcp.popapi.io/health

## Authentication

- Every MCP request must send: `Authorization: Bearer <license_key>`
- The remote endpoint is multi-tenant and stateless.
- The server does not use a shared server-side POP API key for client requests.

## Protocol

- Transport: Streamable HTTP MCP
- POST requests should send:
  - `Content-Type: application/json`
  - `Accept: application/json, text/event-stream`

## First live test

Use JSON-RPC method `tools/list`:

```json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}
```

## Main tool groups

- Invoice generation: `pop_create_sdi_invoice`, `pop_create_peppol_invoice`, `pop_create_pdf_invoice`, `pop_create_ksef_invoice`, `pop_create_zugferd_invoice`, `pop_sync_zoho_document`
- Status and retrieval: `pop_get_invoice_status`, `pop_get_peppol_document`, `pop_get_sdi_document`
- Advanced document operations: `pop_verify_sdi_document`, `pop_preserve_document`
- Onboarding: `pop_onboarding_request_otp`, `pop_onboarding_verify_otp`, `pop_onboarding_get_status`, `pop_onboarding_get_account_setup`, `pop_onboarding_save_account_setup`

## References

- POP platform: https://popapi.io/
- GitHub repository: https://github.com/getpopapi/pop-mcp
- MCP Inspector: https://github.com/modelcontextprotocol/inspector