List clients
Clients, searchable by name, email, short name or tax number.
MCP tool fakturownia_read → list_clients
read
Returns clients from your Fakturownia client list. Pass one search field to find a buyer before you invoice them. Without a filter it returns the first page of all clients.
Parameters
| Name | Type | Description |
|---|---|---|
| name string | string | Client name. |
| tax_no string | string | Tax number (NIP). |
| email string | string | Client email address. |
| shortcut string | string | Short name of the client. |
| page integer | integer | Page number. Default: 1. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "fakturownia_read",
"arguments": {
"operation": "list_clients",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"clients": [
{
"id": 4817,
"name": "Blue Fern Studio",
"tax_no": "1234563218",
"email": "billing@bluefern.example",
"city": "Gdansk",
"country": "PL",
"company": true
}
],
"page": 1
},
"isError": false
}