Codat MCP by usefulapi is an MCP server published by io.usefulapi, hosted at codat.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 28 tools, including codat_get_profile, codat_list_companies, codat_get_company, codat_list_connections, codat_get_connection.
MCP server for Codat — companies, connections, invoices, bills and financial statements.
3,963 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.
Fetch the authenticated Codat account's profile (organization name, redirect URLs, features) — a quick way to verify the API key works. Codat API: GET /profile.
No parameters.
{
"name": "codat_get_profile",
"title": "Get account profile",
"description": "Fetch the authenticated Codat account's profile (organization name, redirect URLs, features) — a quick way to verify the API key works. Codat API: GET /profile.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get account profile",
"readOnlyHint": true
}
}List the companies in your Codat account. A company represents one of your customers' businesses and holds its data connections. Codat API: GET /companies. Returns the paged envelope { results, pageNumber, pageSize, totalResults, _links }.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
{
"name": "codat_list_companies",
"title": "List companies",
"description": "List the companies in your Codat account. A company represents one of your customers' businesses and holds its data connections. Codat API: GET /companies. Returns the paged envelope { results, pageNumber, pageSize, totalResults, _links }.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
}
}
},
"annotations": {
"title": "List companies",
"readOnlyHint": true
}
}Fetch a single company by id (name, platform, dataConnections, created/lastSync). Codat API: GET /companies/{companyId}.
| Parameter | Type | Description |
|---|---|---|
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_get_company",
"title": "Get a company",
"description": "Fetch a single company by id (name, platform, dataConnections, created/lastSync). Codat API: GET /companies/{companyId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "Get a company",
"readOnlyHint": true
}
}List a company's data connections (each links the company to one source platform, e.g. QuickBooks, Xero). Codat API: GET /companies/{companyId}/connections. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_list_connections",
"title": "List data connections",
"description": "List a company's data connections (each links the company to one source platform, e.g. QuickBooks, Xero). Codat API: GET /companies/{companyId}/connections. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "List data connections",
"readOnlyHint": true
}
}Fetch a single data connection by id (platformKey, status, sourceType, lastSync). Codat API: GET /companies/{companyId}/connections/{connectionId}.
| Parameter | Type | Description |
|---|---|---|
| companyId * | string | The Codat companyId (UUID). |
| connectionId * | string | The Codat connectionId (data connection UUID) within the company. |
{
"name": "codat_get_connection",
"title": "Get a data connection",
"description": "Fetch a single data connection by id (platformKey, status, sourceType, lastSync). Codat API: GET /companies/{companyId}/connections/{connectionId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId",
"connectionId"
],
"properties": {
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
},
"connectionId": {
"type": "string",
"description": "The Codat connectionId (data connection UUID) within the company."
}
}
},
"annotations": {
"title": "Get a data connection",
"readOnlyHint": true
}
}Get the freshness/status of each accounting data type for a company (lastSuccessfulSync, currentStatus, dataType). Use this to check whether a dataset has been pulled before reading it. Codat API: GET /companies/{companyId}/dataStatus.
| Parameter | Type | Description |
|---|---|---|
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_get_data_status",
"title": "Get data status",
"description": "Get the freshness/status of each accounting data type for a company (lastSuccessfulSync, currentStatus, dataType). Use this to check whether a dataset has been pulled before reading it. Codat API: GET /companies/{companyId}/dataStatus.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "Get data status",
"readOnlyHint": true
}
}Get a company's accounting metadata (base currency, supported data types, etc.). Codat API: GET /companies/{companyId}/data/info.
| Parameter | Type | Description |
|---|---|---|
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_get_data_info",
"title": "Get accounting metadata",
"description": "Get a company's accounting metadata (base currency, supported data types, etc.). Codat API: GET /companies/{companyId}/data/info.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "Get accounting metadata",
"readOnlyHint": true
}
}List the accounting/commerce/banking platforms (integrations) Codat supports, with their platformKey. Codat API: GET /integrations. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
{
"name": "codat_list_integrations",
"title": "List integrations",
"description": "List the accounting/commerce/banking platforms (integrations) Codat supports, with their platformKey. Codat API: GET /integrations. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
}
}
},
"annotations": {
"title": "List integrations",
"readOnlyHint": true
}
}List a company's chart of accounts (id, name, nominalCode, type, status, currency, currentBalance). Codat API: GET /companies/{companyId}/data/accounts. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_list_accounts",
"title": "List chart of accounts",
"description": "List a company's chart of accounts (id, name, nominalCode, type, status, currency, currentBalance). Codat API: GET /companies/{companyId}/data/accounts. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "List chart of accounts",
"readOnlyHint": true
}
}List a company's accounts-receivable invoices (id, invoiceNumber, customerRef, issueDate, dueDate, currency, totalAmount, amountDue, status, lineItems). Codat API: GET /companies/{companyId}/data/invoices. Returns the paged envelope. Tip: filter with query, e.g. "status=Submitted&&amountDue>0".
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_list_invoices",
"title": "List invoices",
"description": "List a company's accounts-receivable invoices (id, invoiceNumber, customerRef, issueDate, dueDate, currency, totalAmount, amountDue, status, lineItems). Codat API: GET /companies/{companyId}/data/invoices. Returns the paged envelope. Tip: filter with query, e.g. \"status=Submitted&&amountDue>0\".",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true
}
}Fetch a single AR invoice by id (full object incl. lineItems, paymentAllocations). Codat API: GET /companies/{companyId}/data/invoices/{invoiceId}.
| Parameter | Type | Description |
|---|---|---|
| companyId * | string | The Codat companyId (UUID). |
| invoiceId * | string | The invoice id. |
{
"name": "codat_get_invoice",
"title": "Get an invoice",
"description": "Fetch a single AR invoice by id (full object incl. lineItems, paymentAllocations). Codat API: GET /companies/{companyId}/data/invoices/{invoiceId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId",
"invoiceId"
],
"properties": {
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
},
"invoiceId": {
"type": "string",
"description": "The invoice id."
}
}
},
"annotations": {
"title": "Get an invoice",
"readOnlyHint": true
}
}List a company's accounts-payable bills (id, reference, supplierRef, issueDate, dueDate, currency, totalAmount, amountDue, status, lineItems). Codat API: GET /companies/{companyId}/data/bills. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_list_bills",
"title": "List bills",
"description": "List a company's accounts-payable bills (id, reference, supplierRef, issueDate, dueDate, currency, totalAmount, amountDue, status, lineItems). Codat API: GET /companies/{companyId}/data/bills. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "List bills",
"readOnlyHint": true
}
}List a company's bill payments (money paid out to suppliers) — id, supplierRef, date, currency, totalAmount, lines. Codat API: GET /companies/{companyId}/data/billPayments. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_list_bill_payments",
"title": "List bill payments",
"description": "List a company's bill payments (money paid out to suppliers) — id, supplierRef, date, currency, totalAmount, lines. Codat API: GET /companies/{companyId}/data/billPayments. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "List bill payments",
"readOnlyHint": true
}
}List a company's credit notes (id, creditNoteNumber, customerRef, issueDate, currency, totalAmount, remainingCredit, status). Codat API: GET /companies/{companyId}/data/creditNotes. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_list_credit_notes",
"title": "List credit notes",
"description": "List a company's credit notes (id, creditNoteNumber, customerRef, issueDate, currency, totalAmount, remainingCredit, status). Codat API: GET /companies/{companyId}/data/creditNotes. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "List credit notes",
"readOnlyHint": true
}
}List a company's customers (id, customerName, contactName, emailAddress, addresses, status, defaultCurrency). Codat API: GET /companies/{companyId}/data/customers. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_list_customers",
"title": "List customers",
"description": "List a company's customers (id, customerName, contactName, emailAddress, addresses, status, defaultCurrency). Codat API: GET /companies/{companyId}/data/customers. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true
}
}List a company's suppliers/vendors (id, supplierName, contactName, emailAddress, addresses, status, defaultCurrency). Codat API: GET /companies/{companyId}/data/suppliers. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_list_suppliers",
"title": "List suppliers",
"description": "List a company's suppliers/vendors (id, supplierName, contactName, emailAddress, addresses, status, defaultCurrency). Codat API: GET /companies/{companyId}/data/suppliers. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "List suppliers",
"readOnlyHint": true
}
}List a company's payments received (money in against invoices) — id, customerRef, date, currency, totalAmount, lines/allocations. Codat API: GET /companies/{companyId}/data/payments. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_list_payments",
"title": "List payments",
"description": "List a company's payments received (money in against invoices) — id, customerRef, date, currency, totalAmount, lines/allocations. Codat API: GET /companies/{companyId}/data/payments. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "List payments",
"readOnlyHint": true
}
}List a company's journal entries (id, postedOn, createdOn, journalLines with accountRef/netAmount/currency). Codat API: GET /companies/{companyId}/data/journalEntries. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_list_journal_entries",
"title": "List journal entries",
"description": "List a company's journal entries (id, postedOn, createdOn, journalLines with accountRef/netAmount/currency). Codat API: GET /companies/{companyId}/data/journalEntries. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "List journal entries",
"readOnlyHint": true
}
}Get a company's balance sheet, broken into periods. periodLength (months per period) and periodsToCompare are BOTH required by Codat. Codat API: GET /companies/{companyId}/data/financials/balanceSheet.
| Parameter | Type | Description |
|---|---|---|
| companyId * | string | The Codat companyId (UUID). |
| startMonth | string | First month of the earliest period (YYYY-MM-DD); defaults to the most recent. |
| periodLength * | integer | Number of months per period (1-12). Required. |
| periodsToCompare * | integer | How many periods to return (1-12). Required. |
{
"name": "codat_get_balance_sheet",
"title": "Get balance sheet",
"description": "Get a company's balance sheet, broken into periods. periodLength (months per period) and periodsToCompare are BOTH required by Codat. Codat API: GET /companies/{companyId}/data/financials/balanceSheet.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId",
"periodLength",
"periodsToCompare"
],
"properties": {
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
},
"startMonth": {
"type": "string",
"description": "First month of the earliest period (YYYY-MM-DD); defaults to the most recent."
},
"periodLength": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Number of months per period (1-12). Required."
},
"periodsToCompare": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "How many periods to return (1-12). Required."
}
}
},
"annotations": {
"title": "Get balance sheet",
"readOnlyHint": true
}
}Get a company's profit and loss (income statement), broken into periods. periodLength and periodsToCompare are BOTH required by Codat. Codat API: GET /companies/{companyId}/data/financials/profitAndLoss.
| Parameter | Type | Description |
|---|---|---|
| companyId * | string | The Codat companyId (UUID). |
| startMonth | string | First month of the earliest period (YYYY-MM-DD); defaults to the most recent. |
| periodLength * | integer | Number of months per period (1-12). Required. |
| periodsToCompare * | integer | How many periods to return (1-12). Required. |
{
"name": "codat_get_profit_and_loss",
"title": "Get profit & loss",
"description": "Get a company's profit and loss (income statement), broken into periods. periodLength and periodsToCompare are BOTH required by Codat. Codat API: GET /companies/{companyId}/data/financials/profitAndLoss.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId",
"periodLength",
"periodsToCompare"
],
"properties": {
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
},
"startMonth": {
"type": "string",
"description": "First month of the earliest period (YYYY-MM-DD); defaults to the most recent."
},
"periodLength": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Number of months per period (1-12). Required."
},
"periodsToCompare": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "How many periods to return (1-12). Required."
}
}
},
"annotations": {
"title": "Get profit & loss",
"readOnlyHint": true
}
}Get a company's cash flow statement, broken into periods. periodLength and periodsToCompare are BOTH required by Codat. Codat API: GET /companies/{companyId}/data/financials/cashFlowStatement.
| Parameter | Type | Description |
|---|---|---|
| companyId * | string | The Codat companyId (UUID). |
| startMonth | string | First month of the earliest period (YYYY-MM-DD); defaults to the most recent. |
| periodLength * | integer | Number of months per period (1-12). Required. |
| periodsToCompare * | integer | How many periods to return (1-12). Required. |
{
"name": "codat_get_cash_flow_statement",
"title": "Get cash flow statement",
"description": "Get a company's cash flow statement, broken into periods. periodLength and periodsToCompare are BOTH required by Codat. Codat API: GET /companies/{companyId}/data/financials/cashFlowStatement.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId",
"periodLength",
"periodsToCompare"
],
"properties": {
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
},
"startMonth": {
"type": "string",
"description": "First month of the earliest period (YYYY-MM-DD); defaults to the most recent."
},
"periodLength": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Number of months per period (1-12). Required."
},
"periodsToCompare": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "How many periods to return (1-12). Required."
}
}
},
"annotations": {
"title": "Get cash flow statement",
"readOnlyHint": true
}
}List a company's direct costs (point-of-sale purchases: card/cash spend, refunds) for a data connection. NOTE: this endpoint is CONNECTION-scoped. Codat API: GET /companies/{companyId}/connections/{connectionId}/data/directCosts. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
| connectionId * | string | The Codat connectionId (data connection UUID) within the company. |
{
"name": "codat_list_direct_costs",
"title": "List direct costs",
"description": "List a company's direct costs (point-of-sale purchases: card/cash spend, refunds) for a data connection. NOTE: this endpoint is CONNECTION-scoped. Codat API: GET /companies/{companyId}/connections/{connectionId}/data/directCosts. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId",
"connectionId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
},
"connectionId": {
"type": "string",
"description": "The Codat connectionId (data connection UUID) within the company."
}
}
},
"annotations": {
"title": "List direct costs",
"readOnlyHint": true
}
}List a company's account transactions (bank/GL transactions) for a data connection. NOTE: this endpoint is CONNECTION-scoped. Codat API: GET /companies/{companyId}/connections/{connectionId}/data/accountTransactions. Returns the paged envelope.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| query | string | Codat query filter string, e.g. "status=Paid" or "modifiedDate>2026-01-01". See docs.codat.io/using-the-api/querying. |
| orderBy | string | Field to order results by, e.g. "-modifiedDate" (leading "-" for descending). |
| pageSize | integer | Records per page (1-2000, default 100). |
| companyId * | string | The Codat companyId (UUID). |
| connectionId * | string | The Codat connectionId (data connection UUID) within the company. |
{
"name": "codat_list_account_transactions",
"title": "List account transactions",
"description": "List a company's account transactions (bank/GL transactions) for a data connection. NOTE: this endpoint is CONNECTION-scoped. Codat API: GET /companies/{companyId}/connections/{connectionId}/data/accountTransactions. Returns the paged envelope.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId",
"connectionId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"query": {
"type": "string",
"description": "Codat query filter string, e.g. \"status=Paid\" or \"modifiedDate>2026-01-01\". See docs.codat.io/using-the-api/querying."
},
"orderBy": {
"type": "string",
"description": "Field to order results by, e.g. \"-modifiedDate\" (leading \"-\" for descending)."
},
"pageSize": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page (1-2000, default 100)."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
},
"connectionId": {
"type": "string",
"description": "The Codat connectionId (data connection UUID) within the company."
}
}
},
"annotations": {
"title": "List account transactions",
"readOnlyHint": true
}
}Power-user escape hatch: GET any Codat API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Path starts with a slash (e.g. "/companies/{id}/data/taxRates", "/companies/{id}/reports/agedDebtor"). Codat API: GET {path}.
| Parameter | Type | Description |
|---|---|---|
| path * | string | API path starting with a slash, e.g. "/companies/{id}/data/items". |
| query | object | Optional query params object. |
{
"name": "codat_request",
"title": "Raw read request",
"description": "Power-user escape hatch: GET any Codat API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Path starts with a slash (e.g. \"/companies/{id}/data/taxRates\", \"/companies/{id}/reports/agedDebtor\"). Codat API: GET {path}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"description": "API path starting with a slash, e.g. \"/companies/{id}/data/items\"."
},
"query": {
"type": "object",
"description": "Optional query params object.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Raw read request",
"readOnlyHint": true
}
}MUTATES Codat data — create a new company (a container for a customer's data connections). Provide a name; optionally a description, tags, or other attributes via `fields`. Codat API: POST /companies. Returns the created company (incl. its id).
| Parameter | Type | Description |
|---|---|---|
| name * | string | A human-readable name for the company (usually your customer's business name). |
| fields | object | Additional raw Codat fields merged into the request body (escape hatch for any field not typed above). |
| description | string | Optional description / notes for the company. |
{
"name": "codat_create_company",
"title": "Create a company",
"description": "MUTATES Codat data — create a new company (a container for a customer's data connections). Provide a name; optionally a description, tags, or other attributes via `fields`. Codat API: POST /companies. Returns the created company (incl. its id).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "A human-readable name for the company (usually your customer's business name)."
},
"fields": {
"type": "object",
"description": "Additional raw Codat fields merged into the request body (escape hatch for any field not typed above).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": {
"type": "string",
"description": "Optional description / notes for the company."
}
}
},
"annotations": {
"title": "Create a company",
"destructiveHint": true
}
}MUTATES Codat data — create a new data connection on a company for a given source platform. Provide the platformKey (from codat_list_integrations, e.g. "gbol" for QuickBooks Online sandbox). The connection is created in a PendingAuth state; the customer completes authorization via the returned linkUrl. Codat API: POST /companies/{companyId}/connections. Returns the created connection.
| Parameter | Type | Description |
|---|---|---|
| fields | object | Additional raw Codat fields merged into the request body (escape hatch for any field not typed above). |
| companyId * | string | The Codat companyId (UUID). |
| platformKey * | string | The integration platformKey to connect (from codat_list_integrations). |
{
"name": "codat_create_connection",
"title": "Create a data connection",
"description": "MUTATES Codat data — create a new data connection on a company for a given source platform. Provide the platformKey (from codat_list_integrations, e.g. \"gbol\" for QuickBooks Online sandbox). The connection is created in a PendingAuth state; the customer completes authorization via the returned linkUrl. Codat API: POST /companies/{companyId}/connections. Returns the created connection.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId",
"platformKey"
],
"properties": {
"fields": {
"type": "object",
"description": "Additional raw Codat fields merged into the request body (escape hatch for any field not typed above).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
},
"platformKey": {
"type": "string",
"description": "The integration platformKey to connect (from codat_list_integrations)."
}
}
},
"annotations": {
"title": "Create a data connection",
"destructiveHint": true
}
}MUTATES Codat state — queue a refresh of ALL data types for a company (Codat re-pulls from the connected source platforms). Asynchronous: it enqueues pulls, it does not return the data. Use codat_get_data_status to track progress. Codat API: POST /companies/{companyId}/data/all.
| Parameter | Type | Description |
|---|---|---|
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_refresh_all_data",
"title": "Queue a full data refresh",
"description": "MUTATES Codat state — queue a refresh of ALL data types for a company (Codat re-pulls from the connected source platforms). Asynchronous: it enqueues pulls, it does not return the data. Use codat_get_data_status to track progress. Codat API: POST /companies/{companyId}/data/all.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId"
],
"properties": {
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "Queue a full data refresh",
"destructiveHint": true
}
}MUTATES Codat state — queue a refresh of ONE data type for a company (e.g. "invoices", "bills", "chartOfAccounts", "balanceSheet"). Asynchronous: it enqueues a pull, it does not return the data. Codat API: POST /companies/{companyId}/data/queue/{dataType}.
| Parameter | Type | Description |
|---|---|---|
| dataType * | string | The Codat data type key to refresh, e.g. "invoices", "bills", "customers", "chartOfAccounts", "balanceSheet". |
| companyId * | string | The Codat companyId (UUID). |
{
"name": "codat_refresh_data_type",
"title": "Queue a single dataset refresh",
"description": "MUTATES Codat state — queue a refresh of ONE data type for a company (e.g. \"invoices\", \"bills\", \"chartOfAccounts\", \"balanceSheet\"). Asynchronous: it enqueues a pull, it does not return the data. Codat API: POST /companies/{companyId}/data/queue/{dataType}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"companyId",
"dataType"
],
"properties": {
"dataType": {
"type": "string",
"description": "The Codat data type key to refresh, e.g. \"invoices\", \"bills\", \"customers\", \"chartOfAccounts\", \"balanceSheet\"."
},
"companyId": {
"type": "string",
"description": "The Codat companyId (UUID)."
}
}
},
"annotations": {
"title": "Queue a single dataset refresh",
"destructiveHint": true
}
}Tools for Codat, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Show the profit and loss for Acme Ltd for the last 6 months."; "Which customer invoices from Acme Ltd are still unpaid?"; "How fresh is the accounting data we have for Acme Ltd?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Codat data. Free plan: 50 tool calls per month. Run codat_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 codat_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 codat_upgrade without a plan: it returns both plans, each with a payment link for the user to open. codat_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.