io.usefulapi/quaderno
REMOTE · QUADERNO.USEFULAPI.IO · SCANNED AUG 3
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security46
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes. View diagnostics → Unverified
- HTTPS not yet verified: we couldn't determine whether a plaintext access path exists. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability0
- Transport check failed: declared streamable-http, but the endpoint returned HTTP 429. See how to fix → View diagnostics → Fail
Schema Quality & AI Usability0
- Schema not yet verified: we couldn't read the endpoint's schema.Unverified
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage0
- Tool coverage not yet verified: we couldn't read the endpoint's tools.Unverified
Capabilities0
- Capabilities not yet verified: we couldn't read the endpoint's capabilities.Unverified
Unverified: 4 categories
Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · quaderno.usefulapi.io
claude mcp add --transport http io-usefulapi-quaderno https://quaderno.usefulapi.io/mcp
[mcp_servers.io-usefulapi-quaderno] url = "https://quaderno.usefulapi.io/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"io-usefulapi-quaderno": {
"type": "remote",
"url": "https://quaderno.usefulapi.io/mcp",
"enabled": true
}
}
} openclaw mcp add io-usefulapi-quaderno --url https://quaderno.usefulapi.io/mcp --transport streamable-http
mcp_servers:
io-usefulapi-quaderno:
url: "https://quaderno.usefulapi.io/mcp" {
"mcpServers": {
"io-usefulapi-quaderno": {
"type": "http",
"url": "https://quaderno.usefulapi.io/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 −53
- Endpoint reachability: reachable → not serving MCP ▼ security
- Authorization: pass → unverified ▼ security
- Stability: 0.20 → unverified ▼ security
- Transport: pass → fail ▼ security
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: fail → unverified ▼ functional
- 2 Aug 26 +53
- Authorization: unverified → pass ▲ security
- Transport: fail → pass ▲ security
- MCP protocol: unverified → fail ▼ functional
- Endpoint reachability: not serving MCP → reachable ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Stability: unverified → 0.20 ▲ functional
- 1 Aug 26 −52
- Endpoint reachability: reachable → not serving MCP ▼ security
- Stability: 0.13 → unverified ▼ security
- Authorization: pass → unverified ▼ security
- Transport: pass → fail ▼ security
- Capabilities: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- 31 Jul 26 +4
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −2
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 29 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 28 Jul 26 0
- Stability: unverified → 0.03 ▲ functional
- 27 Jul 26 +55
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://quaderno.usefulapi.io/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=usefulapi.io | CN=WE1,O=Google Trust Services,C=US | 17 Jul 2026 | 15 Oct 2026 | ECDSA 256 | ECDSA-SHA256 | c0df0e8f036da89213dc8c8e092c711a |
| SANs: usefulapi.io, quaderno.usefulapi.io, *.quaderno.usefulapi.io | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
DNSSEC insecure
Validation of quaderno.usefulapi.io. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| io. | present | 57355 | 8 | Verified |
| usefulapi.io. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 429 |
| Header | Value |
|---|---|
| x-frame-options | SAMEORIGIN |
| referrer-policy | same-origin |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://quaderno.usefulapi.io/mcp | HTTP error | 429 | |
| http (plaintext) | http://quaderno.usefulapi.io/mcp | Inconclusive | 429 |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
calculate_tax Calculate tax rate ~374
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 }.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | — | Transaction amount to compute the tax on. |
| currency | string | — | ISO 4217 currency code (e.g. "USD"). |
| date | string | — | Transaction date (YYYY-MM-DD); defaults to today. |
| from_country | string | — | The seller's country (2-letter ISO); defaults to the account country. |
| from_postal_code | string | — | The seller's postal code. |
| product_type | string | — | Whether the product is a good or a service. |
| tax_behavior | string | — | Whether the amount includes tax or not. |
| tax_code | string | — | Product tax code, e.g. "standard", "reduced", "exempt", "eservice", "ebook", "saas", "consulting". |
| 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). |
| to_country | string | yes | The customer's country — 2-letter ISO code (e.g. "US", "DE"). Required. |
| to_postal_code | string | — | The customer's ZIP / postal code (recommended for US sales tax). |
| to_street | string | — | The customer's street address (recommended for US sales tax). |
No output schema declared.
No examples provided.
create_contact Create a contact ~221
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.
| Name | Type | Req | Description |
|---|---|---|---|
| contact_name | string | — | The contact person's name at a company (companies only). |
| country | string | — | 2-letter ISO country code. |
| string | — | Contact email address. | |
| fields | object | — | Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above). |
| first_name | string | — | For a person: their first name. For a company: the company name (Quaderno stores it here). |
| kind | string | yes | Contact kind. |
| last_name | string | — | The person's last name (persons only). |
| tax_id | string | — | The contact's tax ID / VAT number. |
No output schema declared.
No examples provided.
create_invoice Create an invoice ~266
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).
| Name | Type | Req | Description |
|---|---|---|---|
| contact_id | string | — | The id of an existing contact to invoice. Omit only if you pass a full `contact` object via `fields`. |
| currency | string | — | ISO 4217 currency code. |
| due_date | string | — | Due date (YYYY-MM-DD). |
| fields | object | — | Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above). |
| issue_date | string | — | Issue date (YYYY-MM-DD). |
| items | array | — | Line items, e.g. [{ description, quantity, unit_price, tax_1_name, tax_1_rate }]. |
| notes | string | — | Free-text notes on the invoice. |
| po_number | string | — | Purchase-order number. |
No output schema declared.
No examples provided.
create_item Create a product (item) ~172
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.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | — | SKU / product code. |
| currency | string | — | ISO 4217 currency code. |
| fields | object | — | Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above). |
| kind | string | — | Whether it is a one-off or a subscription product. |
| name | string | yes | Product name. |
| product_type | string | — | Whether the product is a good or a service. |
| unit_cost | number | yes | Unit price of the product. |
No output schema declared.
No examples provided.
create_transaction Create a transaction ~232
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.
| Name | Type | Req | Description |
|---|---|---|---|
| currency | string | — | ISO 4217 currency code. |
| customer | object | — | The customer contact object (or reference), e.g. { first_name, last_name, email, country, tax_id }. |
| fields | object | — | Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above). |
| items | array | yes | Required. Transaction line items, e.g. [{ description, amount, quantity, tax_code, product_type }]. |
| payment | object | — | Payment object, e.g. { payment_method, amount, date }. |
| type | string | — | Transaction type (default "sale"). |
No output schema declared.
No examples provided.
get_contact Get a contact ~35
Fetch a single contact by id. Quaderno API: GET /contacts/{id}.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The resource id. |
No output schema declared.
No examples provided.
get_credit_note Get a credit note ~38
Fetch a single credit note by id. Quaderno API: GET /credit_notes/{id}.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The resource id. |
No output schema declared.
No examples provided.
get_expense Get an expense ~36
Fetch a single expense by id. Quaderno API: GET /expenses/{id}.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The resource id. |
No output schema declared.
No examples provided.
get_invoice Get an invoice ~50
Fetch a single invoice by id (full object incl. items, taxes, payments, permalink, pdf). Quaderno API: GET /invoices/{id}.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The resource id. |
No output schema declared.
No examples provided.
get_item Get a product (item) ~36
Fetch a single product/item by id. Quaderno API: GET /items/{id}.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The resource id. |
No output schema declared.
No examples provided.
get_receipt Get a receipt ~37
Fetch a single receipt by id. Quaderno API: GET /receipts/{id}.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The resource id. |
No output schema declared.
No examples provided.
list_contacts List contacts ~149
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.
| Name | Type | Req | Description |
|---|---|---|---|
| created_before | string | — | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
| page | integer | — | Page number (legacy pagination; prefer created_before). |
| per_page | integer | — | Entries per page (1-100, default 25). |
| q | string | — | Search by contact name, email, or tax ID. |
No output schema declared.
No examples provided.
list_credit_notes List credit notes ~165
List credit notes (refund documents), newest first. Quaderno API: GET /credit_notes. Wrapped as { data, pagination } when more pages exist.
| Name | Type | Req | Description |
|---|---|---|---|
| contact | string | — | Filter by customer (contact) id. |
| created_before | string | — | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
| date | string | — | Date range filter, e.g. "2026-01-01,2026-12-31". |
| page | integer | — | Page number (legacy pagination; prefer created_before). |
| per_page | integer | — | Entries per page (1-100, default 25). |
| q | string | — | Search by number, customer name, or PO number. |
No output schema declared.
No examples provided.
list_expenses List expenses ~161
List expenses (bills you received), newest first. Quaderno API: GET /expenses. Wrapped as { data, pagination } when more pages exist.
| Name | Type | Req | Description |
|---|---|---|---|
| contact | string | — | Filter by vendor (contact) id. |
| created_before | string | — | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
| date | string | — | Date range filter, e.g. "2026-01-01,2026-12-31". |
| page | integer | — | Page number (legacy pagination; prefer created_before). |
| per_page | integer | — | Entries per page (1-100, default 25). |
| q | string | — | Search by number or vendor name. |
No output schema declared.
No examples provided.
list_invoices List invoices ~211
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.
| Name | Type | Req | Description |
|---|---|---|---|
| contact | string | — | Filter by customer (contact) id. |
| created_before | string | — | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
| date | string | — | Date range filter, e.g. "2026-01-01,2026-12-31". |
| page | integer | — | Page number (legacy pagination; prefer created_before). |
| per_page | integer | — | Entries per page (1-100, default 25). |
| q | string | — | Search by invoice number, customer name, or PO number. |
| state | string | — | Filter by invoice state. |
No output schema declared.
No examples provided.
list_items List products (items) ~134
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.
| Name | Type | Req | Description |
|---|---|---|---|
| created_before | string | — | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
| page | integer | — | Page number (legacy pagination; prefer created_before). |
| per_page | integer | — | Entries per page (1-100, default 25). |
No output schema declared.
No examples provided.
list_jurisdictions List tax jurisdictions ~43
List the tax jurisdictions (id, name, country, region) where the account is registered to collect tax. Quaderno API: GET /jurisdictions.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_receipts List receipts ~157
List receipts, newest first. Quaderno API: GET /receipts. Wrapped as { data, pagination } when more pages exist.
| Name | Type | Req | Description |
|---|---|---|---|
| contact | string | — | Filter by customer (contact) id. |
| created_before | string | — | Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id). |
| date | string | — | Date range filter, e.g. "2026-01-01,2026-12-31". |
| page | integer | — | Page number (legacy pagination; prefer created_before). |
| per_page | integer | — | Entries per page (1-100, default 25). |
| q | string | — | Search by number or customer name. |
No output schema declared.
No examples provided.
list_tax_codes List tax codes ~45
List the product tax codes Quaderno supports (id, name, description) — used as the tax_code on products / tax calculations. Quaderno API: GET /tax_codes.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_webhooks List webhooks ~32
List the account's configured webhooks (id, url, events). Quaderno API: GET /webhooks.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
ping Ping (verify auth) ~33
Verify the API key and connection by pinging Quaderno. Returns account/authentication status. Quaderno API: GET /ping.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
quaderno_request Raw read request ~97
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}.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | API path after /api, starting with a slash, e.g. "/tax_ids". |
| query | object | — | Optional query params object. |
No output schema declared.
No examples provided.
update_contact Update a contact ~163
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.
| Name | Type | Req | Description |
|---|---|---|---|
| contact_name | string | — | Contact person at a company. |
| country | string | — | 2-letter ISO country code. |
| string | — | Contact email address. | |
| fields | object | — | Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above). |
| first_name | string | — | Person first name / company name. |
| id | string | yes | The resource id. |
| last_name | string | — | Person last name. |
| tax_id | string | — | Tax ID / VAT number. |
No output schema declared.
No examples provided.