Quaderno MCP by usefulapi is an MCP server published by io.usefulapi, hosted at quaderno.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 23 tools, including quaderno_ping, quaderno_calculate_tax, quaderno_list_invoices, quaderno_get_invoice, quaderno_list_contacts.
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
4,292 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Verify the API key and connection by pinging Quaderno. Returns account/authentication status. Quaderno API: GET /ping.
No parameters.
{
"name": "quaderno_ping",
"title": "Ping (verify auth)",
"description": "Verify the API key and connection by pinging Quaderno. Returns account/authentication status. Quaderno API: GET /ping.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Ping (verify auth)",
"readOnlyHint": true
}
}Calculate the correct tax rate/amount for a sale given the customer's location and product. This is Quaderno's flagship endpoint — it applies the right VAT / GST / US sales-tax rules per jurisdiction. READ-ONLY (no record is created). Quaderno API: GET /tax_rates/calculate. Returns { name, rate, country, region, county, city, tax_code, status (taxable|non_taxable|not_registered|reverse_charge), tax_amount, subtotal, total_amount }.
| Parameter | Type | Description |
|---|---|---|
| date | string | Transaction date (YYYY-MM-DD); defaults to today. |
| amount | number | Transaction amount to compute the tax on. |
| tax_id | string | The customer's tax ID / VAT number (may trigger reverse-charge). |
| to_city | string | The customer's city (recommended for US sales tax). |
| currency | string | ISO 4217 currency code (e.g. "USD"). |
| tax_code | string | Product tax code, e.g. "standard", "reduced", "exempt", "eservice", "ebook", "saas", "consulting". |
| to_street | string | The customer's street address (recommended for US sales tax). |
| to_country * | string | The customer's country — 2-letter ISO code (e.g. "US", "DE"). Required. |
| from_country | string | The seller's country (2-letter ISO); defaults to the account country. |
| product_type | string | Whether the product is a good or a service. |
| tax_behavior | string | Whether the amount includes tax or not. |
| to_postal_code | string | The customer's ZIP / postal code (recommended for US sales tax). |
{
"name": "quaderno_calculate_tax",
"title": "Calculate tax rate",
"description": "Calculate the correct tax rate/amount for a sale given the customer's location and product. This is Quaderno's flagship endpoint — it applies the right VAT / GST / US sales-tax rules per jurisdiction. READ-ONLY (no record is created). Quaderno API: GET /tax_rates/calculate. Returns { name, rate, country, region, county, city, tax_code, status (taxable|non_taxable|not_registered|reverse_charge), tax_amount, subtotal, total_amount }.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"to_country"
],
"properties": {
"date": {
"type": "string",
"description": "Transaction date (YYYY-MM-DD); defaults to today."
},
"amount": {
"type": "number",
"description": "Transaction amount to compute the tax on."
},
"tax_id": {
"type": "string",
"description": "The customer's tax ID / VAT number (may trigger reverse-charge)."
},
"to_city": {
"type": "string",
"description": "The customer's city (recommended for US sales tax)."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code (e.g. \"USD\")."
},
"tax_code": {
"type": "string",
"description": "Product tax code, e.g. \"standard\", \"reduced\", \"exempt\", \"eservice\", \"ebook\", \"saas\", \"consulting\"."
},
"to_street": {
"type": "string",
"description": "The customer's street address (recommended for US sales tax)."
},
"to_country": {
"type": "string",
"description": "The customer's country — 2-letter ISO code (e.g. \"US\", \"DE\"). Required."
},
"from_country": {
"type": "string",
"description": "The seller's country (2-letter ISO); defaults to the account country."
},
"product_type": {
"enum": [
"good",
"service"
],
"type": "string",
"description": "Whether the product is a good or a service."
},
"tax_behavior": {
"enum": [
"inclusive",
"exclusive"
],
"type": "string",
"description": "Whether the amount includes tax or not."
},
"to_postal_code": {
"type": "string",
"description": "The customer's ZIP / postal code (recommended for US sales tax)."
},
"from_postal_code": {
"type": "string",
"description": "The seller's postal code."
}
}
},
"annotations": {
"title": "Calculate tax rate",
"readOnlyHint": true
}
}List invoices, newest first, with optional filters. Quaderno API: GET /invoices. Returns invoice objects (id, number, issue_date, due_date, currency, contact, items, taxes, payments, state, total_cents, subtotal_cents), wrapped as { data, pagination } when more pages exist.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search by invoice number, customer name, or PO number. |
| date | string | Date range filter, e.g. "2026-01-01,2026-12-31". |
| page | integer | Page number (legacy pagination; prefer created_before). |
| state | string | Filter by invoice state. |
| contact | string | Filter by customer (contact) id. |
| per_page | integer | Entries per page (1-100, default 25). |
| created_before | string | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
{
"name": "quaderno_list_invoices",
"title": "List invoices",
"description": "List invoices, newest first, with optional filters. Quaderno API: GET /invoices. Returns invoice objects (id, number, issue_date, due_date, currency, contact, items, taxes, payments, state, total_cents, subtotal_cents), wrapped as { data, pagination } when more pages exist.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"description": "Search by invoice number, customer name, or PO number."
},
"date": {
"type": "string",
"description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (legacy pagination; prefer created_before)."
},
"state": {
"enum": [
"outstanding",
"late",
"uncollectible",
"paid"
],
"type": "string",
"description": "Filter by invoice state."
},
"contact": {
"type": "string",
"description": "Filter by customer (contact) id."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Entries per page (1-100, default 25)."
},
"created_before": {
"type": "string",
"description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true
}
}Fetch a single invoice by id (full object incl. items, taxes, payments, permalink, pdf). Quaderno API: GET /invoices/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The resource id. |
{
"name": "quaderno_get_invoice",
"title": "Get an invoice",
"description": "Fetch a single invoice by id (full object incl. items, taxes, payments, permalink, pdf). Quaderno API: GET /invoices/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The resource id."
}
}
},
"annotations": {
"title": "Get an invoice",
"readOnlyHint": true
}
}List contacts (customers/vendors), newest first. Quaderno API: GET /contacts. Returns contact objects (id, kind, first_name, last_name, contact_name, email, country, tax_id, tax_status, …), wrapped as { data, pagination } when more pages exist.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search by contact name, email, or tax ID. |
| page | integer | Page number (legacy pagination; prefer created_before). |
| per_page | integer | Entries per page (1-100, default 25). |
| created_before | string | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
{
"name": "quaderno_list_contacts",
"title": "List contacts",
"description": "List contacts (customers/vendors), newest first. Quaderno API: GET /contacts. Returns contact objects (id, kind, first_name, last_name, contact_name, email, country, tax_id, tax_status, …), wrapped as { data, pagination } when more pages exist.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"description": "Search by contact name, email, or tax ID."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (legacy pagination; prefer created_before)."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Entries per page (1-100, default 25)."
},
"created_before": {
"type": "string",
"description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true
}
}Fetch a single contact by id. Quaderno API: GET /contacts/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The resource id. |
{
"name": "quaderno_get_contact",
"title": "Get a contact",
"description": "Fetch a single contact by id. Quaderno API: GET /contacts/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The resource id."
}
}
},
"annotations": {
"title": "Get a contact",
"readOnlyHint": true
}
}List products/items in the catalog, newest first. Quaderno API: GET /items. Returns item objects (id, code, name, kind, product_type, unit_cost, tax_class, tax_type, currency, stock, …), wrapped as { data, pagination } when more pages exist.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (legacy pagination; prefer created_before). |
| per_page | integer | Entries per page (1-100, default 25). |
| created_before | string | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
{
"name": "quaderno_list_items",
"title": "List products (items)",
"description": "List products/items in the catalog, newest first. Quaderno API: GET /items. Returns item objects (id, code, name, kind, product_type, unit_cost, tax_class, tax_type, currency, stock, …), wrapped as { data, pagination } when more pages exist.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (legacy pagination; prefer created_before)."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Entries per page (1-100, default 25)."
},
"created_before": {
"type": "string",
"description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
}
}
},
"annotations": {
"title": "List products (items)",
"readOnlyHint": true
}
}Fetch a single product/item by id. Quaderno API: GET /items/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The resource id. |
{
"name": "quaderno_get_item",
"title": "Get a product (item)",
"description": "Fetch a single product/item by id. Quaderno API: GET /items/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The resource id."
}
}
},
"annotations": {
"title": "Get a product (item)",
"readOnlyHint": true
}
}List credit notes (refund documents), newest first. Quaderno API: GET /credit_notes. Wrapped as { data, pagination } when more pages exist.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search by number, customer name, or PO number. |
| date | string | Date range filter, e.g. "2026-01-01,2026-12-31". |
| page | integer | Page number (legacy pagination; prefer created_before). |
| contact | string | Filter by customer (contact) id. |
| per_page | integer | Entries per page (1-100, default 25). |
| created_before | string | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
{
"name": "quaderno_list_credit_notes",
"title": "List credit notes",
"description": "List credit notes (refund documents), newest first. Quaderno API: GET /credit_notes. Wrapped as { data, pagination } when more pages exist.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"description": "Search by number, customer name, or PO number."
},
"date": {
"type": "string",
"description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (legacy pagination; prefer created_before)."
},
"contact": {
"type": "string",
"description": "Filter by customer (contact) id."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Entries per page (1-100, default 25)."
},
"created_before": {
"type": "string",
"description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
}
}
},
"annotations": {
"title": "List credit notes",
"readOnlyHint": true
}
}Fetch a single credit note by id. Quaderno API: GET /credit_notes/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The resource id. |
{
"name": "quaderno_get_credit_note",
"title": "Get a credit note",
"description": "Fetch a single credit note by id. Quaderno API: GET /credit_notes/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The resource id."
}
}
},
"annotations": {
"title": "Get a credit note",
"readOnlyHint": true
}
}List receipts, newest first. Quaderno API: GET /receipts. Wrapped as { data, pagination } when more pages exist.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search by number or customer name. |
| date | string | Date range filter, e.g. "2026-01-01,2026-12-31". |
| page | integer | Page number (legacy pagination; prefer created_before). |
| contact | string | Filter by customer (contact) id. |
| per_page | integer | Entries per page (1-100, default 25). |
| created_before | string | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
{
"name": "quaderno_list_receipts",
"title": "List receipts",
"description": "List receipts, newest first. Quaderno API: GET /receipts. Wrapped as { data, pagination } when more pages exist.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"description": "Search by number or customer name."
},
"date": {
"type": "string",
"description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (legacy pagination; prefer created_before)."
},
"contact": {
"type": "string",
"description": "Filter by customer (contact) id."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Entries per page (1-100, default 25)."
},
"created_before": {
"type": "string",
"description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
}
}
},
"annotations": {
"title": "List receipts",
"readOnlyHint": true
}
}Fetch a single receipt by id. Quaderno API: GET /receipts/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The resource id. |
{
"name": "quaderno_get_receipt",
"title": "Get a receipt",
"description": "Fetch a single receipt by id. Quaderno API: GET /receipts/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The resource id."
}
}
},
"annotations": {
"title": "Get a receipt",
"readOnlyHint": true
}
}List expenses (bills you received), newest first. Quaderno API: GET /expenses. Wrapped as { data, pagination } when more pages exist.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search by number or vendor name. |
| date | string | Date range filter, e.g. "2026-01-01,2026-12-31". |
| page | integer | Page number (legacy pagination; prefer created_before). |
| contact | string | Filter by vendor (contact) id. |
| per_page | integer | Entries per page (1-100, default 25). |
| created_before | string | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
{
"name": "quaderno_list_expenses",
"title": "List expenses",
"description": "List expenses (bills you received), newest first. Quaderno API: GET /expenses. Wrapped as { data, pagination } when more pages exist.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"description": "Search by number or vendor name."
},
"date": {
"type": "string",
"description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (legacy pagination; prefer created_before)."
},
"contact": {
"type": "string",
"description": "Filter by vendor (contact) id."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Entries per page (1-100, default 25)."
},
"created_before": {
"type": "string",
"description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
}
}
},
"annotations": {
"title": "List expenses",
"readOnlyHint": true
}
}Fetch a single expense by id. Quaderno API: GET /expenses/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The resource id. |
{
"name": "quaderno_get_expense",
"title": "Get an expense",
"description": "Fetch a single expense by id. Quaderno API: GET /expenses/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The resource id."
}
}
},
"annotations": {
"title": "Get an expense",
"readOnlyHint": true
}
}List the product tax codes Quaderno supports (id, name, description) — used as the tax_code on products / tax calculations. Quaderno API: GET /tax_codes.
No parameters.
{
"name": "quaderno_list_tax_codes",
"title": "List tax codes",
"description": "List the product tax codes Quaderno supports (id, name, description) — used as the tax_code on products / tax calculations. Quaderno API: GET /tax_codes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List tax codes",
"readOnlyHint": true
}
}List the tax jurisdictions (id, name, country, region) where the account is registered to collect tax. Quaderno API: GET /jurisdictions.
No parameters.
{
"name": "quaderno_list_jurisdictions",
"title": "List tax jurisdictions",
"description": "List the tax jurisdictions (id, name, country, region) where the account is registered to collect tax. Quaderno API: GET /jurisdictions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List tax jurisdictions",
"readOnlyHint": true
}
}List the account's configured webhooks (id, url, events). Quaderno API: GET /webhooks.
No parameters.
{
"name": "quaderno_list_webhooks",
"title": "List webhooks",
"description": "List the account's configured webhooks (id, url, events). Quaderno API: GET /webhooks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List webhooks",
"readOnlyHint": true
}
}Power-user escape hatch: GET any Quaderno API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Path is taken after /api (e.g. "/tax_ids", "/evidence"). Quaderno API: GET {path}.
| Parameter | Type | Description |
|---|---|---|
| path * | string | API path after /api, starting with a slash, e.g. "/tax_ids". |
| query | object | Optional query params object. |
{
"name": "quaderno_request",
"title": "Raw read request",
"description": "Power-user escape hatch: GET any Quaderno API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Path is taken after /api (e.g. \"/tax_ids\", \"/evidence\"). Quaderno API: GET {path}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"description": "API path after /api, starting with a slash, e.g. \"/tax_ids\"."
},
"query": {
"type": "object",
"description": "Optional query params object.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Raw read request",
"readOnlyHint": true
}
}MUTATES Quaderno data — create a contact (customer or vendor). Provide kind plus a name; use `fields` for any other Quaderno contact attribute (phone_1, region, postal_code, city, street_line_1/2, tax_status, language, discount, notes, processor/processor_id). Quaderno API: POST /contacts. Returns the created contact.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | Contact kind. |
| string | Contact email address. | |
| fields | object | Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above). |
| tax_id | string | The contact's tax ID / VAT number. |
| country | string | 2-letter ISO country code. |
| last_name | string | The person's last name (persons only). |
| first_name | string | For a person: their first name. For a company: the company name (Quaderno stores it here). |
| contact_name | string | The contact person's name at a company (companies only). |
MUTATES Quaderno data — update an existing contact. Only the fields you pass are changed; use `fields` for any attribute not typed here. Quaderno API: PUT /contacts/{id}. Returns the updated contact.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The resource id. |
| string | Contact email address. | |
| fields | object | Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above). |
| tax_id | string | Tax ID / VAT number. |
| country | string | 2-letter ISO country code. |
| last_name | string | Person last name. |
| first_name | string | Person first name / company name. |
| contact_name | string | Contact person at a company. |
{
"name": "quaderno_update_contact",
"title": "Update a contact",
"description": "MUTATES Quaderno data — update an existing contact. Only the fields you pass are changed; use `fields` for any attribute not typed here. Quaderno API: PUT /contacts/{id}. Returns the updated contact.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The resource id."
},
"email": {
"type": "string",
"description": "Contact email address."
},
"fields": {
"type": "object",
"description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tax_id": {
"type": "string",
"description": "Tax ID / VAT number."
},
"country": {
"type": "string",
"description": "2-letter ISO country code."
},
"last_name": {
"type": "string",
"description": "Person last name."
},
"first_name": {
"type": "string",
"description": "Person first name / company name."
},
"contact_name": {
"type": "string",
"description": "Contact person at a company."
}
}
},
"annotations": {
"title": "Update a contact",
"destructiveHint": true
}
}MUTATES Quaderno data — create a product/item in the catalog. Provide name + unit_cost; use `fields` for any other attribute (code, description, tax_class, tax_type, currency, country, stock). Quaderno API: POST /items. Returns the created item.
| Parameter | Type | Description |
|---|---|---|
| code | string | SKU / product code. |
| kind | string | Whether it is a one-off or a subscription product. |
| name * | string | Product name. |
| fields | object | Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above). |
| currency | string | ISO 4217 currency code. |
| unit_cost * | number | Unit price of the product. |
| product_type | string | Whether the product is a good or a service. |
{
"name": "quaderno_create_item",
"title": "Create a product (item)",
"description": "MUTATES Quaderno data — create a product/item in the catalog. Provide name + unit_cost; use `fields` for any other attribute (code, description, tax_class, tax_type, currency, country, stock). Quaderno API: POST /items. Returns the created item.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"unit_cost"
],
"properties": {
"code": {
"type": "string",
"description": "SKU / product code."
},
"kind": {
"enum": [
"one_off",
"subscription"
],
"type": "string",
"description": "Whether it is a one-off or a subscription product."
},
"name": {
"type": "string",
"description": "Product name."
},
"fields": {
"type": "object",
"description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code."
},
"unit_cost": {
"type": "number",
"description": "Unit price of the product."
},
"product_type": {
"enum": [
"good",
"service"
],
"type": "string",
"description": "Whether the product is a good or a service."
}
}
},
"annotations": {
"title": "Create a product (item)",
"destructiveHint": true
}
}MUTATES Quaderno data — create an invoice for a contact. Provide contact_id (or a contact via `fields`) and items; use `fields` for any other attribute (currency, issue_date, due_date, po_number, notes, tag_list, custom_metadata, payment_details). Each item = { description, quantity, unit_price, tax_1_name?, tax_1_rate?, discount_rate?, … }. Quaderno API: POST /invoices. Returns the created invoice (incl. permalink, pdf).
| Parameter | Type | Description |
|---|---|---|
| items | array | Line items, e.g. [{ description, quantity, unit_price, tax_1_name, tax_1_rate }]. |
| notes | string | Free-text notes on the invoice. |
| fields | object | Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above). |
| currency | string | ISO 4217 currency code. |
| due_date | string | Due date (YYYY-MM-DD). |
| po_number | string | Purchase-order number. |
| contact_id | string | The id of an existing contact to invoice. Omit only if you pass a full `contact` object via `fields`. |
| issue_date | string | Issue date (YYYY-MM-DD). |
MUTATES Quaderno data — record a sale or refund transaction (Quaderno computes tax and produces the compliant document). Provide the customer, items, and payment. Use `fields` for any other attribute (date, currency, shipping_address, evidence, processor, processor_id, processor_fee_cents, exchange_rate, po_number, notes, tags, custom_metadata). Quaderno API: POST /transactions. Returns the created invoice/credit-note object.
| Parameter | Type | Description |
|---|---|---|
| type | string | Transaction type (default "sale"). |
| items * | array | Required. Transaction line items, e.g. [{ description, amount, quantity, tax_code, product_type }]. |
| fields | object | Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above). |
| payment | object | Payment object, e.g. { payment_method, amount, date }. |
| currency | string | ISO 4217 currency code. |
| customer | object | The customer contact object (or reference), e.g. { first_name, last_name, email, country, tax_id }. |
{
"name": "quaderno_create_transaction",
"title": "Create a transaction",
"description": "MUTATES Quaderno data — record a sale or refund transaction (Quaderno computes tax and produces the compliant document). Provide the customer, items, and payment. Use `fields` for any other attribute (date, currency, shipping_address, evidence, processor, processor_id, processor_fee_cents, exchange_rate, po_number, notes, tags, custom_metadata). Quaderno API: POST /transactions. Returns the created invoice/credit-note object.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"items"
],
"properties": {
"type": {
"enum": [
"sale",
"refund"
],
"type": "string",
"description": "Transaction type (default \"sale\")."
},
"items": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Required. Transaction line items, e.g. [{ description, amount, quantity, tax_code, product_type }]."
},
"fields": {
"type": "object",
"description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"payment": {
"type": "object",
"description": "Payment object, e.g. { payment_method, amount, date }.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code."
},
"customer": {
"type": "object",
"description": "The customer contact object (or reference), e.g. { first_name, last_name, email, country, tax_id }.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Create a transaction",
"destructiveHint": true
}
}Tools for Quaderno, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "List the invoices we issued last month and their totals."; "What tax rate applies to an ebook sold to a customer in Austin, US ZIP code 78701?"; "Which expenses did I record this quarter?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Quaderno data. Free plan: 50 tool calls per month. Run quaderno_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run quaderno_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run quaderno_upgrade without a plan: it returns both plans, each with a payment link for the user to open. quaderno_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| from_postal_code | string | The seller's postal code. |
{
"name": "quaderno_create_contact",
"title": "Create a contact",
"description": "MUTATES Quaderno data — create a contact (customer or vendor). Provide kind plus a name; use `fields` for any other Quaderno contact attribute (phone_1, region, postal_code, city, street_line_1/2, tax_status, language, discount, notes, processor/processor_id). Quaderno API: POST /contacts. Returns the created contact.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"company",
"person"
],
"type": "string",
"description": "Contact kind."
},
"email": {
"type": "string",
"description": "Contact email address."
},
"fields": {
"type": "object",
"description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"tax_id": {
"type": "string",
"description": "The contact's tax ID / VAT number."
},
"country": {
"type": "string",
"description": "2-letter ISO country code."
},
"last_name": {
"type": "string",
"description": "The person's last name (persons only)."
},
"first_name": {
"type": "string",
"description": "For a person: their first name. For a company: the company name (Quaderno stores it here)."
},
"contact_name": {
"type": "string",
"description": "The contact person's name at a company (companies only)."
}
}
},
"annotations": {
"title": "Create a contact",
"destructiveHint": true
}
}{
"name": "quaderno_create_invoice",
"title": "Create an invoice",
"description": "MUTATES Quaderno data — create an invoice for a contact. Provide contact_id (or a contact via `fields`) and items; use `fields` for any other attribute (currency, issue_date, due_date, po_number, notes, tag_list, custom_metadata, payment_details). Each item = { description, quantity, unit_price, tax_1_name?, tax_1_rate?, discount_rate?, … }. Quaderno API: POST /invoices. Returns the created invoice (incl. permalink, pdf).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Line items, e.g. [{ description, quantity, unit_price, tax_1_name, tax_1_rate }]."
},
"notes": {
"type": "string",
"description": "Free-text notes on the invoice."
},
"fields": {
"type": "object",
"description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code."
},
"due_date": {
"type": "string",
"description": "Due date (YYYY-MM-DD)."
},
"po_number": {
"type": "string",
"description": "Purchase-order number."
},
"contact_id": {
"type": "string",
"description": "The id of an existing contact to invoice. Omit only if you pass a full `contact` object via `fields`."
},
"issue_date": {
"type": "string",
"description": "Issue date (YYYY-MM-DD)."
}
}
},
"annotations": {
"title": "Create an invoice",
"destructiveHint": true
}
}