List contacts
Customers and suppliers with ID, name, organisation number, email and customer or supplier number.
MCP tool fiken_read → list_contacts
read
Lists the contacts of the company. Search by name or organisation number to check whether a contact exists before creating one, and filter by role to get only customers or only suppliers. Use contact_id as customer_id in create_invoice and as supplier_id in create_purchase. Pages hold up to 100 contacts; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| search string | string | Contact name or organisation number. |
| role enum | enum | all, customer or supplier. Default: all. |
| limit integer | integer | 1 to 100. Default: 25. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "fiken_read",
"arguments": {
"operation": "list_contacts",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"contacts": [
{
"contact_id": 4021188,
"name": "Nordlys Design AS",
"organisation_number": "912345678",
"email": "okonomi@nordlys.example",
"customer_number": 10003,
"supplier_number": null
}
],
"next_cursor": null
},
"isError": false
}