Connect Ascora to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the get invoices tool in Ascora
Use the mark payments as sent tool in Ascora
Use the get payments tool in Ascora
Use the mark invoices as sent tool in Ascora
Use the submit enquiry tool in Ascora
Use the list customers tool in Ascora
Supported Tools
get_invoices
Get Invoices
Retrieves invoices from the Ascora Accounting API that have not yet been marked as sent to an accounting system. Optionally filter by date and company.
Returns full invoice details including header information, customer data, and line items. Use **Mark Invoices** after processing to prevent re-retrieval.
mark_payments
Mark Payments as Sent
Marks one or more payments as successfully sent to an external accounting system. Once marked, these payments will no longer be returned by the Get Payments tool.
Use this after you have successfully processed and pushed payments to your accounting package (e.g., Xero, QuickBooks, MYOB).
get_payments
Get Payments
Retrieves payments from the Ascora Accounting API that have not yet been marked as sent to an accounting system.
Only returns payments linked to invoices that have already been marked as sent. Use **Mark Payments** after processing to prevent re-retrieval.
mark_invoices
Mark Invoices as Sent
Marks one or more invoices as successfully sent to an external accounting system. Once marked, these invoices will no longer be returned by the Get Invoices tool.
Use this after you have successfully processed and pushed invoices to your accounting package (e.g., Xero, QuickBooks, MYOB).
submit_enquiry
Submit Enquiry
Creates a new enquiry in Ascora from external data such as website contact forms or CRM systems. The enquiry can later be converted into a Quote or Job within Ascora.
Supports contact details, address information, a description of the enquiry, and any number of custom fields configured in your Ascora account.
list_customers
List Customers
Searches a page of customers from Ascora. Returns customer records including contact details and company information.
Use this to look up existing customers, sync customer data to external systems, or verify customer records.
get_customer
Get Customer
Retrieve one Ascora customer, including contact details, addresses, customer type and custom fields. Use list_customers to discover the customer ID.
get_job
Get Job
Retrieve an Ascora job by its full job number, including status, customer relationships, address and pricing. Use list_jobs to find a job number.
list_jobs
List Jobs
Search a page of Ascora jobs by status, customer, assigned user, job type, creation date or text. Use a returned job number with get_job for full details.
Enable Ascora in Metorial. In your Metorial portal, enable the Ascora MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Ascora tools.
Enable Ascora in Metorial. In your Metorial portal, enable the Ascora MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Ascora tools.
Enable Ascora in Metorial. In your Metorial portal, enable the Ascora MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Ascora tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Ascora in Metorial. In your Metorial portal, enable the Ascora MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Ascora tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Ascora in Metorial. In your Metorial portal, enable the Ascora MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Ascora tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Ascora through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Ascora and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Ascora tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Search and retrieve customers and jobs, submit enquiries with contact details and custom fields, and retrieve invoices and payments for accounting synchronisation. Mark invoices and payments as sent after successfully processing them in an external accounting system.
Frequently asked questions
Common questions about connecting Ascora to AI agents with Metorial.
How many tools does the Ascora MCP server have?
The Ascora MCP server exposes 9 tools, including Get Invoices, Mark Payments as Sent, Get Payments. Each one is governed and traced through Metorial.
Does the Ascora MCP server support triggers?
Ascora exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Ascora MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Ascora MCP server through the same Metorial URL.
How do I give only some teams access to Ascora?
Use role-based access control to decide which teams, users, and agents can use Ascora and which of its tools they can call.
Can I self-host the Ascora MCP server?
Yes. Metorial is open source, so you can run the Ascora MCP server yourself or use the hosted gateway.
Connect Ascora to production AI agents
See how Metorial gives your team governed access to Ascora, with tracing and security controls built in.