mcp-bigcapital
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BIGCAPITAL_API_KEY | Yes | Your Bigcapital API key. | |
| BIGCAPITAL_BASE_URL | Yes | The Bigcapital app origin, for example http://localhost:3000. Do not append /api. | |
| BIGCAPITAL_TOOL_PROFILE | No | Tool profile: 'agency' (default) or 'full'. | agency |
| BIGCAPITAL_ORGANIZATION_ID | No | Your organization ID, if required. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_customersC | List customers using Bigcapital list filters. |
| list_vendorsC | List vendors using Bigcapital list filters. |
| list_itemsC | List items using Bigcapital list filters. |
| list_accountsC | List chart-of-account records using Bigcapital list filters. |
| list_invoicesC | List sale invoices using Bigcapital list filters. |
| list_billsC | List vendor bills using Bigcapital list filters. |
| list_expensesC | List expenses using Bigcapital list filters. |
| create_invoiceC | Create a sale invoice in Bigcapital. |
| create_billC | Create a vendor bill in Bigcapital. |
| create_expenseC | Create an expense in Bigcapital. Assumption: categories follows the generated SDK string[] type. |
| get_accountB | Get an account by ID. |
| get_customerA | Get a customer by ID. |
| create_customerC | Create a customer. |
| update_customerD | Update a customer. |
| get_vendorA | Get a vendor by ID. |
| create_vendorC | Create a vendor. |
| update_vendorC | Update a vendor. |
| list_manual_journalsC | List manual journals using Bigcapital list filters. |
| get_manual_journalA | Get a manual journal by ID. |
| create_manual_journalD | Create a manual journal. |
| update_manual_journalD | Update a manual journal. |
| publish_manual_journalC | Publish a manual journal. |
| get_invoiceA | Get a sale invoice by ID. |
| update_invoiceC | Update a sale invoice. |
| list_sale_receiptsC | List sale receipts using Bigcapital list filters. |
| get_sale_receiptB | Get a sale receipt by ID. |
| create_sale_receiptC | Create a sale receipt. |
| update_sale_receiptC | Update a sale receipt. |
| close_sale_receiptC | Close a sale receipt. |
| list_payments_receivedA | List payments received. |
| get_payment_receivedA | Get a payment received by ID. |
| create_payment_receivedC | Create a payment received record. |
| update_payment_receivedC | Update a payment received record. |
| get_billB | Get a bill by ID. |
| update_billC | Update a bill. |
| open_billD | Open a bill. |
| list_due_billsC | List due bills. |
| get_expenseA | Get an expense by ID. |
| update_expenseC | Update an expense. |
| publish_expenseD | Publish an expense. |
| list_bill_paymentsB | List bill payments. |
| get_bill_paymentB | Get a bill payment by ID. |
| create_bill_paymentC | Create a bill payment. |
| update_bill_paymentD | Update a bill payment. |
| get_itemB | Get an item by ID. |
| create_itemC | Create an item. |
| update_itemD | Update an item. |
| get_profit_lossC | Get the Bigcapital profit and loss report. |
| get_balance_sheetC | Get the Bigcapital balance sheet report. |
| get_trial_balanceC | Get the Bigcapital trial balance report. |
| get_cashflow_statementC | Get the cashflow statement report. |
| get_general_ledgerC | Get the general ledger report. |
| get_transactions_by_customersC | Get the transactions by customers report. |
| get_receivable_aging_summaryC | Get the receivable aging summary report. |
| get_payable_aging_summaryC | Get the payable aging summary report. |
| upload_attachmentC | Upload an attachment from a local file path. |
| get_attachment_presigned_urlA | Get a presigned URL for an attachment by attachment ID. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 57 tools
Tools are generally named around distinct Bigcapital resources (vendor, customer, bill, invoice, expense, journal, receipt, payment, report), so an agent can usually tell them apart. The main ambiguities are between payments received and bill payments, and among status-changing actions like open_bill, publish_expense, and close_sale_receipt, but the descriptions are clear enough to resolve those.
Tool names consistently follow a lower_snake verb_noun pattern: list_*, get_*, create_*, update_* across resources, with a few expected domain verbs like open, publish, and close. Even compound resources like get_attachment_presigned_url still follow a predictable action-first structure.
With 57 tools, this is an extreme tool surface that will be costly for an agent to navigate and likely to cause misselection. Although the accounting domain is broad, this many operations should be split into focused server modules rather than exposed as one flat set.
The toolset covers a wide range of accounting lifecycles: customers, vendors, items, invoices, bills, expenses, receipts, payments, journals, attachments, and key financial reports. However, delete operations are almost entirely absent, and accounts are read-only (list/get but no create/update), leaving some workflows without full lifecycle support.