MCP Server: Connect AI Assistants to DualEntry

DualEntry provides a Model Context Protocol (MCP) server: a standardized interface that lets any compatible AI assistant or agent access your accounting data securely. Connect an MCP-compatible client and ask questions about your records, accounts, vendors, and customers in natural language. The server is remote and hosted by DualEntry. You do not install anything locally. Point your client at one URL and sign in with your DualEntry credentials.

Property	Value
Server URL	`https://api.dualentry.com/mcp/`
Transport	Streamable HTTP
Authentication	OAuth 2.1 (browser sign-in, no API keys)

Your MCP permissions match your DualEntry role. If you cannot see something in the dashboard, you cannot see it through MCP either.

Add to Cursor

Select the button below to install the DualEntry MCP server in Cursor with one click. Cursor opens an install prompt, then a browser window to sign in with your DualEntry credentials.

If the button does not open Cursor, make sure Cursor is installed and up to date, then use the Cursor tab below to add the server manually.

Client setup

Pick your client below. Each tab includes a copy-paste-ready configuration. Every client connects to the same server URL and uses the same browser-based sign-in.

One-click: use the Add to Cursor button above.Manual: open Cursor Settings > MCP > Add new MCP server, or add the server to your mcp.json file:

{
  "mcpServers": {
    "dualentry": {
      "url": "https://api.dualentry.com/mcp/"
    }
  }
}

After saving, Cursor opens a browser window to sign in with your DualEntry credentials.

Open claude.ai and go to Settings > Connectors.
Select Add custom connector.
Enter the URL: https://api.dualentry.com/mcp/
Select Add.
Complete the authentication prompt in your browser.

Custom connectors require a Claude Pro, Max, Team, or Enterprise plan. On Team and Enterprise plans, only workspace Owners can add connectors (via Organization Settings > Connectors). Members can then enable and authenticate with connectors that an Owner has added.

Add the server from your terminal:

claude mcp add --transport http dualentry https://api.dualentry.com/mcp/

The first time you use a DualEntry tool, Claude Code opens a browser window for sign-in.

VS Code (with GitHub Copilot) supports remote MCP servers. Add the server to your .vscode/mcp.json file:

{
  "servers": {
    "dualentry": {
      "type": "http",
      "url": "https://api.dualentry.com/mcp/"
    }
  }
}

Reload the window, then start the server from the MCP: List Servers command. VS Code opens a browser window to authenticate.

Connect the server from the Codex CLI:

codex --mcp-server https://api.dualentry.com/mcp/

Codex opens a browser window for sign-in on first connection.

Any MCP client that supports Streamable HTTP transport and OAuth 2.1 can connect using the server URL:

https://api.dualentry.com/mcp/

Refer to your client’s documentation for how to add a remote MCP server. When you connect for the first time, your client opens a browser window for you to sign in with your DualEntry credentials.

Authentication

No API keys are needed. You sign in with the same DualEntry credentials you use for the dashboard.

On first connection, your MCP client opens a browser for login.
Sessions refresh automatically.
Your permissions match your DualEntry role. If you cannot see something in the dashboard, you cannot see it through MCP either.

Available tools

Tools respect your organization’s permissions and company-level access restrictions.

Record retrieval

Tool	Description
`search_records`	Search for accounting records with filters (type, vendor/customer name, date range, amount range). Supports pagination with `offset` and `limit` (max 1,000 per page).
`get_record_detail`	Get full details for a specific record by its transaction ID.
`get_record_by_number`	Look up a record by its number (e.g., `JE-123`, `BI-456`, `IN-789`).
`get_record_history`	Get the audit trail for a specific record.
`get_related_records`	Find records related to a given record (e.g., payments linked to an invoice).
`get_record_schema`	Get the field schema for a record type (bill, invoice, journal_entry, etc.).
`list_supported_transactions`	List all supported record types and whether they support creation.

Entity search

Tool	Description
`search_entities`	Search for entities (vendors, customers, accounts, companies, items, classifications, terms) by name. Supports pagination with `offset` and `limit`. Returns ID, name, and type-specific fields (e.g., account number, currency, email).

Record & entity creation

Tool	Description
`create_draft_record`	Create a draft accounting record for review. Does not save to database.
`validate_record`	Validate record data before saving (checks required fields, entity existence, balancing).
`save_record`	Save a new accounting record to the database.
`create_draft_entity`	Create a draft entity (vendor, customer, etc.) for review. Does not save to database.
`save_entity`	Save a new entity to the database.

Example conversations

Once connected, you can ask your AI assistant questions like:

“Show me all invoices from last month over $5,000”
“Look up journal entry JE-412 and show me its line items”
“What payments are linked to invoice IN-1089?”
“Search for vendors matching ‘Acme’”
“Create a bill for vendor Acme Corp, $500 for office supplies”

Permissions

MCP access is governed by your DualEntry role. Tools check permissions before returning data:

Permission Required	Tools
Transactions	`search_records`, `get_record_detail`, `get_record_by_number`, `get_record_history`, `get_related_records`, `get_record_schema`, `list_supported_transactions`
Record Creation	`create_draft_record`, `validate_record`, `save_record` (per record type)
Chart of Accounts	`search_entities` (account)
Companies	`search_entities` (company)
Customers	`search_entities` (customer)
Vendors	`search_entities` (vendor)
Items	`search_entities` (item)
Classifications	`search_entities` (classification)
Terms	`search_entities` (term)
Entity Creation	`create_draft_entity`, `save_entity` (per entity type)

If you lack a required permission, the tool returns a “Permission denied” message.

Troubleshooting

General

Issue	Solution
”Permission denied” on a tool	Your DualEntry role does not include the required permission. Ask your administrator to update your access.
Stale data after permission change	Sign out and back in to apply changes immediately.

Cursor

Issue	Solution
”Add to Cursor” button does nothing	Confirm Cursor is installed and up to date, then add the server manually using the Cursor tab.
Server shows as disconnected	Open Cursor Settings > MCP and toggle the server off and on to retrigger the browser sign-in.

Claude

Issue	Solution
Connector not available	Custom connectors require a Claude Pro, Max, Team, or Enterprise plan. On Team/Enterprise plans, only Owners can add connectors.

Custom MCP clients

These issues apply when connecting via third-party clients that use OAuth 2.1 to authenticate with the MCP server.

Issue	Solution
Login window does not appear	Your client must support OAuth 2.1-based MCP servers. Update to the latest version and verify OAuth support in your client’s documentation.
Connection timeout	Verify the MCP URL (`https://api.dualentry.com/mcp/`) is correct and that you can reach `api.dualentry.com` from your network.

Authentication: how DualEntry secures API and MCP access.
DualEntry Public API: the REST API behind the same accounting data.

Developer Guide

V2 (latest)

V1

Release Notes & Changelog

MCP Server: Connect AI Assistants to DualEntry

Add to Cursor

Client setup

Authentication

Available tools

Record retrieval

Entity search

Record & entity creation

Example conversations

Permissions

Troubleshooting

General

Cursor

Claude

Custom MCP clients

​Add to Cursor

​Client setup

​Authentication

​Available tools

​Record retrieval

​Entity search

​Record & entity creation

​Example conversations

​Permissions

​Troubleshooting

​General

​Cursor

​Claude

​Custom MCP clients

​Related

Add to Cursor

Client setup

Authentication

Available tools

Record retrieval

Entity search

Record & entity creation

Example conversations

Permissions

Troubleshooting

General

Cursor

Claude

Custom MCP clients

Related