Productivity

vatbuild.com

MCP server for classifying UK construction invoice line items against HMRC VAT rules and managing VATBuild projects and routing decisions.

1 endpoint21 known toolsFirst detected September 19, 2026Last detected September 19, 2026

ENDPOINT 1

https://vatbuild.com/mcp

No auth detected

MCP server metadata

Name: vatbuild-mcp
Version: 1.5.2

Capabilities

tools.listChanged

Server instructions

UK construction VAT analysis under HMRC Notice 708. Call check_line_item first — it classifies any invoice line (correct rate, overcharged, zero-rated) with no API key required. For a full HMRC 431NB/431C reclaim project, authenticate with a Bearer key, then use set_up_project → route_line_item → answer_vat_complex_question to build a complete VAT report. Full agent workflow guide: https://vatbuild.com/docs/agent-workflow-guide

Known tools 21

check_line_item

Classify any UK construction invoice line item against HMRC Notice 708 VAT rules.

Potential side effects

list_projects

Return all VATBuild projects for the authenticated user's organisation.

Inferred read-only

list_line_items

Return a paginated summary of invoice line items for a VATBuild project.

Potential side effects

route_line_item

Classify and persist the VAT routing decision for a specific line item in a VATBuild project.

Inferred read-only

answer_vat_complex_question

Submit the answer to a complex-VAT confirmation question for a specific line item.

Inferred read-only

reclassify_companion_items

Re-route all line items on an invoice document using the current invoice-level context.

Potential side effects

set_up_project

Create a new VATBuild project for the authenticated user.

Potential side effects

assess_project_eligibility

Run a lightweight HMRC VAT eligibility check on a VATBuild project before uploading invoices.

Inferred read-only

create_account

Create a free VATBuild account.

Potential side effects

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.

Inferred read-only

poll_authentication

Poll for the result of a pending authenticate_account device-code request.

Inferred read-only

check_account_status

Return account status for the authenticated user.

Inferred read-only

list_invoices

Return a summary list of all non-archived invoices uploaded to a VATBuild project.

Inferred read-only

get_invoice

Retrieve the full extracted document for a single invoice — header fields plus all extracted line items with their current VAT routing outcomes.

Potential side effects

generate_report

Generate a structured claim-schedule report for a VATBuild project.

Inferred read-only

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.

Potential side effects

list_plan_items

List confirmed plan items for a VATBuild project.

Inferred read-only

suggest_plan_items

Generate suggested plan items for a VATBuild project from a plain-English description.

Inferred read-only

confirm_plan_item

Confirm a suggested plan item, transitioning it from 'suggested' to 'assessed'.

Inferred read-only

update_plan_item

Update user-editable fields on a confirmed plan item.

Potential side effects

remove_plan_item

Hard-delete a plan item from a project.

Potential side effects

CONNECT WITH APPROVAL

Client installation

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.vatbuild-mcp]
url = "https://vatbuild.com/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "vatbuild-mcp": {
      "type": "http",
      "url": "https://vatbuild.com/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: vatbuild-mcp
Remote MCP URL: https://vatbuild.com/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "vatbuild-mcp": {
      "url": "https://vatbuild.com/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "vatbuild-mcp": {
      "type": "http",
      "url": "https://vatbuild.com/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "vatbuild-mcp",
  "transport": "streamable-http",
  "url": "https://vatbuild.com/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

TRUST AND VERIFICATION EVIDENCE

Loading Trust v2 evidence…

Checking the associated registrable domain. The BuiltWith key remains server-side.

Indexed

Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.