This listing identifies a third-party MCP server. MCPBundles is not affiliated with, sponsored by, or endorsed by the service or its operator unless stated on this page.
This server may ask you to sign in when your AI client connects.
Last probed Nov 3, 2026 · www.vatbuild.com
21tools discovered
For AI agents — MCPBundles Directory API
For MCP client apps (human connect):
MCP connect URL: https://www.vatbuild.com/mcp
Skill page: https://www.mcpbundles.com/skills/vatbuild-mcp-7b638b55ec
Explore capabilities (21)
read 8
write 13
List
4
Check
2
Other capabilities
15
Check Line Item
read
check_line_item
Classify any UK construction invoice line item against HMRC Notice 708 VAT rules.
Use this tool whenever a user asks a construction VAT question involving a specific supply,
invoice line, or material — even if they have no VATBuild project set up yet.
This is the right tool for questions like:
- "Can I reclaim VAT on this invoice?"
- "What VAT rate should my contractor charge for this work?"
- "Is scaffolding reclaimable on a new build?"
- "My builder charged 20% on labour — is that correct?"
-
Description may be truncated on the public preview.
Check Line Item — Classify any UK construction invoice line item against HMRC Notice 708 VAT rules.
Use this tool whenever a user asks a construction VAT question involving a specific supply,
invoice line, or material — even if they have no VATBuild project set up yet.
This is the right tool for questions like:
- "Can I reclaim VAT on this invoice?"
- "What VAT rate should my contractor charge for this work?"
- "Is scaffolding reclaimable on a new build?"
- "My builder charged 20% on labour — is that correct?"
-
List Projects — Return all VATBuild projects for the authenticated user's organisation.
Requires Authorization: Bearer vb_live_<key>. Obtain a key via authenticate_account
+ poll_authentication, or from Account → API Keys in the web app.
Use this tool to discover which projects exist before calling other tools.
Each project in the response includes its id, name, VAT scheme (claimantRoute),
journey status, the computed journeyStage (four-value enum — see below), whether
the profile has been confirmed, the curr
List Line Items — Return a paginated summary of invoice line items for a VATBuild project.
Requires Authorization: Bearer vb_live_<key>. Obtain a key via authenticate_account
+ poll_authentication, or from Account → API Keys in the web app.
Each item in the response includes its current VAT routing outcome so an AI agent
can identify which items still need routing (reviewStatus='pending') and which are
already resolved (reviewStatus='approved' or 'no_action').
── claimRoute and reclaimAmount ──────────────────
Route Line Item — Classify and persist the VAT routing decision for a specific line item in a VATBuild project.
Requires Authorization: Bearer vb_live_<key> with the line_items:write scope.
Obtain a key via authenticate_account + poll_authentication, or from Account → API Keys in the web app.
API-key callers must hold the line_items:write scope; session callers hold all scopes automatically.
Differs from check_line_item in two ways:
1. Takes projectId + lineItemId instead of inline project context — ownership
Answer VAT Complex Question — Submit the answer to a complex-VAT confirmation question for a specific line item.
Requires Authorization: Bearer vb_live_<key> with the line_items:write scope.
Obtain a key via authenticate_account + poll_authentication, or from Account → API Keys in the web app.
Some line items require a yes/no question before VAT routing can be determined — for
example: 'Did a contractor install these energy-saving materials? (Yes covers both supply-and-install and installation-only.)'.
This tool persists t
Get your MCP into directories
A working endpoint is step one. Directory coverage is the coordinated launch across ChatGPT, Claude, Cursor, the MCP Registry, and community indexes.
Use the MCP endpoint listed on this page in your MCP client configuration. One-click install pills support Claude, Cursor, VS Code, and other hosts. Copy the remote MCP URL if your client needs a manual entry.
How many tools does VATBuild provide?
Operate this server?
Request removal if you do not want VATBuild listed here, or claim the listing if you want to manage it on MCPBundles.
Operate VATBuild?
This server appears in the MCPBundles directory. Verify you operate it to take over the listing — name, description, logo, contact email, and skill content. We email a 6-digit code to a maintainer address your server publishes in /.well-known/security.txt or /.well-known/mcpbundles.json. Free, takes about a minute.
MCPBundles publishes this directory for MCP discovery. Except where we host or operate an offering, third-party services run under their own terms. Product and company names on this page are used in a descriptive, identifying way (including under nominative fair use where applicable); they remain the property of their owners. Nothing here grants you rights in those marks, and nothing here is an offer to sell a third party's services. Terms · Request removal
More in developer tools
Other MCP servers in this category from the directory index
Reclassify Companion Items — Re-route all line items on an invoice document using the current invoice-level context.
Requires Authorization: Bearer vb_live_<key> with the line_items:write scope.
Obtain a key via authenticate_account + poll_authentication, or from Account → API Keys in the web app.
Call this after answer_vat_complex_question returns crossItemContextRequired: true.
When an ESM installation or supply-and-install question is answered, the routing of
companion items on the same invoice may change. This tool re
Set Up Project — Create a new VATBuild project for the authenticated user.
Requires Authorization: Bearer vb_live_<key>. Obtain a key via authenticate_account
+ poll_authentication, or from Account → API Keys in the web app.
The project is created in an unconfirmed-profile state — the full AI wizard assessment
has not run yet. The tool returns a direct link (projectUrl) to the project in the
VATBuild web app where the user can confirm their profile and begin uploading invoices.
claimantRoute values:
self_bu
Assess Project Eligibility — Run a lightweight HMRC VAT eligibility check on a VATBuild project before uploading invoices.
Requires Authorization: Bearer vb_live_<key>. Obtain a key via authenticate_account
+ poll_authentication, or from Account → API Keys in the web app.
Use this tool after set_up_project to confirm whether the chosen VAT scheme (claimantRoute)
and building details genuinely qualify under HMRC Notice 708, before the user spends time
uploading and processing invoices that would turn out ineligible.
The t
Create Account — Create a free VATBuild account.
Sends a confirmation email to the provided address. The account (user, org,
and API key) is NOT created immediately — it is only materialised when the
user clicks the one-time confirmation link in their email. Until then, no
account rows exist and no API key is available.
Rate-limited: 3 requests per IP per hour to prevent email spam.
Idempotent: calling again for the same pending address refreshes the token
and resends the confirmation email rather than creatin
Authenticate Account — ⭐ OAuth-capable clients (Claude Desktop, ChatGPT) connect automatically:
These clients drive the OAuth 2.1 / PKCE browser flow at the transport
layer — no agent involvement is needed. If your MCP client opened a browser
window to connect VATBuild, you are already authenticated. Do NOT call this
tool in that case. This device-code flow is only for clients that cannot
obtain tokens via the OAuth browser flow (e.g. Gemini CLI, custom clients).
Request API access for an existing VATBuild
Poll Authentication — Poll for the result of a pending authenticate_account device-code request.
⭐ OAuth-capable clients (Claude Desktop, ChatGPT) do not use this tool:
Those clients connected via browser OAuth automatically — no polling needed.
Only call this tool if authenticate_account was called explicitly (device-code
flow for clients without OAuth browser support).
⚠ HOST COMPATIBILITY NOTICE:
Standard MCP hosts (Claude Desktop, ChatGPT, Gemini CLI) read the Authorization
header from a static con
Check Account Status — Return account status for the authenticated user.
Requires a Bearer token in the Authorization header (API key or OAuth 2.1 access
token) — do NOT pass it as a tool argument. MCP tool arguments appear in LLM
conversation transcripts; passing credentials there puts long-lived secrets into
third-party chat logs.
Use this after create_account / authenticate_account to confirm the key works
before calling other tools. Also use it as the required post-reconnect verification
step when switching acco
List Invoices — Return a summary list of all non-archived invoices uploaded to a VATBuild project.
Requires Authorization: Bearer vb_live_<key>. Obtain a key via authenticate_account
+ poll_authentication, or from Account → API Keys in the web app.
Use this tool to answer questions like:
- "What invoices have I uploaded?"
- "Who supplied this item?" (when you need the supplier name without enumerating line items)
- "How many line items does this invoice have?"
- "Which invoices have validation problems?"
Eac
Get Invoice — Retrieve the full extracted document for a single invoice — header fields plus all
extracted line items with their current VAT routing outcomes.
Requires Authorization: Bearer vb_live_<key>. Obtain a key via authenticate_account
+ poll_authentication, or from Account → API Keys in the web app.
Use this tool to answer questions like:
- "Did my upload work? What did it extract?"
- "What line items are on this specific invoice?"
- "What is the total reclaimable amount for this invoice?"
- "Which
Generate Report — Generate a structured claim-schedule report for a VATBuild project.
Requires Authorization: Bearer vb_live_<key>. Obtain a key via authenticate_account
+ poll_authentication, or from Account → API Keys in the web app.
Use this tool to answer questions like:
- "What is my total HMRC reclaim amount?"
- "Which suppliers do I need to chase for corrected invoices?"
- "Is my project ready to submit to HMRC?"
- "Give me a full breakdown of my VAT claim."
The report separates the two distinct recover
Submit Invoice Data — Upload a base64-encoded invoice file (JPEG, PNG, WebP, or PDF) to a VATBuild project and queue
it for AI extraction and VAT classification.
Requires Authorization: Bearer vb_live_<key> with the invoices:write or line_items:write scope.
Obtain a key via authenticate_account + poll_authentication, or from Account → API Keys in the web app.
Use this tool when the user wants to submit an invoice photo, scan, or PDF directly from an AI
agent without visiting the VATBuild web app. After submission,
List Plan Items — List confirmed plan items for a VATBuild project.
Returns all items with status 'assessed' or 'added', ordered by sort_order.
Suggested items (status 'suggested') are not included — use suggest_plan_items to generate
suggestions, then confirm_plan_item to move each one into the confirmed list.
Each item exposes only agent-facing fields: itemId, name, categoryHeading, vatTreatment,
claimRoute, vatComplex, status, notes, and sortOrder. Internal library keys are never exposed.
Use this tool to r
Suggest Plan Items — Generate suggested plan items for a VATBuild project from a plain-English description.
Accepts a plain-English description of the project or body of work (e.g. '4-bed timber frame
new build with underfloor heating, oak flooring, and a detached garage'). The assessment
pipeline matches the description to library work-package items, computes a VAT assessment
for each match, and persists the suggestions as project_plan_items rows with status 'suggested'.
You may also pass documentIds — UUIDs of p
Confirm Plan Item — Confirm a suggested plan item, transitioning it from 'suggested' to 'assessed'.
After suggest_plan_items returns a list of suggestions, call this tool for each suggestion
the user accepts. Confirmed items appear in list_plan_items results and are considered part
of the project's planned scope.
Only items with status 'suggested' can be confirmed. Items already at 'assessed' or 'added'
return an INVALID_STATUS error.
To reject a suggestion instead, call remove_plan_item.
Requires authenticatio
Update Plan Item — Update user-editable fields on a confirmed plan item.
Allows agents to set name, notes, and sortOrder on any plan item (assessed or added).
Assessment fields (vatTreatment, claimRoute, likelihood, etc.) cannot be changed via this
tool — they are set by the assessment pipeline.
All fields are optional — omit a field to leave it unchanged. Pass notes: null to clear notes.
Requires authentication. No additional scope beyond authentication.
Remove Plan Item — Hard-delete a plan item from a project.
Works for both suggested items (status 'suggested') and confirmed items (status 'assessed'
or 'added'). Use this to reject a suggestion or remove an unwanted item from the confirmed plan.
This operation is permanent — deleted items cannot be recovered. To get a fresh set of
suggestions after removing items, call suggest_plan_items again.
Requires authentication. No additional scope beyond authentication.
MCPBundles probed 21 tools on the live server. The tool list on this page reflects what was discovered at the last refresh — connect your client to see the full set available to your session.
What authentication does VATBuild require?
VATBuild may require signing in to the provider before tools can run. Connect through MCPBundles or your MCP client and complete any provider login when prompted.
Don't want this listed?
Request removal from the MCPBundles directory. We stop publishing this listing on mcpbundles.com.
MCPBundles is an independent platform built on the open Model Context Protocol standard. MCPBundles is not affiliated with, sponsored by, or endorsed by Anthropic PBC.