# ePoslovanje MCP by usefulapi

> ePoslovanje MCP by usefulapi is an MCP server. Validate and send e-invoices, track their status and check AMS registration in ePoslovanje. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/eposlovanje/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/eposlovanje
- **MCP Registry name:** io.usefulapi/eposlovanje
- **Listing updated:** 2026-11-13

## About

Validate and send e-invoices, track their status and check AMS registration in ePoslovanje.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http eposlovanje https://eposlovanje.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://eposlovanje.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "eposlovanje": {
      "url": "https://eposlovanje.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "eposlovanje": {
      "type": "http",
      "url": "https://eposlovanje.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "eposlovanje": {
      "serverUrl": "https://eposlovanje.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "eposlovanje": {
      "type": "http",
      "url": "https://eposlovanje.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `eposlovanje_ping`: Check that the ePoslovanje service is up and that the API key is accepted. Cheapest call. GET /api/v2/ping.
- `eposlovanje_get_account_balance`: Get the account type (Prepaid or Postpaid) and the prepaid balance, or the postpaid usage. GET /api/v2/account/balance.
- `eposlovanje_get_f2_settings`: Get the automatic fiscalization settings for incoming and outgoing invoices (F2.0). GET /api/v2/account/f2settings.
- `eposlovanje_list_business_units`: List the business units (poslovne jedinice) of a company by its OIB, in the format used on e-invoices. GET /api/v2/businessunits/{vatid}.
- `eposlovanje_list_incoming_documents`: List e-invoices received by the account (suppliers' invoices to us), with filters by insert, modify and issue date. GET /api/v2/document/incoming.
- `eposlovanje_list_outgoing_documents`: List e-invoices sent by the account (our invoices to customers), with filters by insert, modify and issue date. GET /api/v2/document/outgoing.
- `eposlovanje_get_document`: Get the signed XML of one incoming or outgoing e-invoice by its ePoslovanje id. Archived documents may not be returned. GET /api/v2/document/get/{id}.
- `eposlovanje_get_document_status`: Get the status history (transport, business and e-reporting) of one document by its ePoslovanje id. GET /api/v2/document/status/{id}.
- `eposlovanje_lookup_document_status`: Get the status of one invoice by its invoice number, both OIBs and the issue year (no ePoslovanje id needed). GET /api/v2/document/statuslookup.
- `eposlovanje_validate_document`: Validate an e-invoice XML against the EN16931 / CIUS-2025 rules without sending it. Returns a list of errors, empty when valid. POST /api/v2/document/validate. Nothing is stored or sent.
- `eposlovanje_list_ereporting_requests`: List the e-reporting (eIzvještavanje, Tax Authority fiscalization) requests for one invoice. GET /api/v2/ereporting/requests.
- `eposlovanje_check_ams`: Check whether a company (by OIB or GLN) is published on the Tax Authority AMS service, so e-invoices can reach it. POST /api/v2/ams/check. Read-only lookup.
- `eposlovanje_send_document`: Send an UBL 2.1 Invoice or CreditNote XML to the buyer through ePoslovanje. The document is validated, signed, and queued for the buyer's intermediary. A sent invoice cannot be unsent. Each send costs about 0.08 EUR + VAT on the account. Use eposlovanje_validate_document first. POST /api/v2/document/send.
- `eposlovanje_change_document_status`: Set the business status of a received invoice: 5 approved, 6 rejected, 7 fully paid. Changing to rejected does not send an e-reporting request. Only the buyer can change these statuses. POST /api/v2/document/changestatus/{id}.

## FAQ

### How do I add ePoslovanje MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http eposlovanje https://eposlovanje.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/eposlovanje-mcp-by-usefulapi
