Create contractor
Add a contractor to your iFirma list.
MCP tool ifirma_write → create_contractor
write
Creates a contractor record. Name, postal code and city are required. Nothing is sent to anyone, and the contractor can be edited or deleted in the app, so create_contractor runs without asking first.
Parameters
| Name | Type | Description |
|---|---|---|
| name string required | string | Contractor name, up to 150 characters. |
| postal_code string required | string | Postal code. |
| city string required | string | City. |
| street string | string | Street and number. |
| nip string | string | Tax number (NIP). |
| country_code string | string | Two-letter country code. |
| email string | string | Email address used for sending invoices and reminders. |
| private_person boolean | boolean | true for a private person. Default: false. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ifirma_write",
"arguments": {
"operation": "create_contractor",
"arguments": {
"name": "Jane Doe",
"postal_code": "postal code",
"city": "city"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"id": "c_4901",
"name": "Lime Courier Sp. z o.o.",
"nip": "9512345678",
"email": "office@limecourier.example",
"city": "Warsaw",
"postal_code": "00-001",
"country_code": "PL"
},
"isError": false
}