Repository avatar
Other Tools
v1.1.1
active

taptax

uk.co.taptax/taptax

UK tax: take-home pay, self-employed and company tax, VAT, stamp duty, invoices and MTD.

Documentation

TapTax

TapTax MCP server

TapTax is Making Tax Digital (MTD) software for UK sole traders and landlords. This repository holds the public connection details for the TapTax MCP server, plus ready-made plugins for Claude Code and Cursor. The server itself is hosted by TapTax; there is nothing to install or run.

Ask in plain English: how much tax you owe so far this year, which transactions still need reviewing, log this receipt, invoice a client, or get your quarterly update ready. The 37 public tools work with no account: the tax estimate, PAYE tax code checker, MTD eligibility and deadlines, and every calculator at taptax.co.uk/tax-calculator.

Connect

Claude

Connect TapTax from the Claude directory in Claude on the web, desktop and mobile, or add a custom connector with the server URL above. The plugin in this repository uses the same server URL, so if you have both you see one set of TapTax tools, not two.

Claude Code

Install the plugin from this repository:

/plugin marketplace add udohsolomon/taptax-mcp
/plugin install taptax@taptax

Or add just the server:

claude mcp add --transport http taptax https://api.taptax.co.uk/mcp

Then run /mcp, choose taptax and Authenticate to use your own records.

Cursor

Add the TapTax plugin from cursor.directory, or add the server to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "taptax": { "url": "https://api.taptax.co.uk/mcp" }
  }
}

VS Code

code --add-mcp '{"name":"taptax","type":"http","url":"https://api.taptax.co.uk/mcp"}'

Any other MCP client

Point it at https://api.taptax.co.uk/mcp over Streamable HTTP. The account tools answer an unauthenticated call with HTTP 401 and a WWW-Authenticate header naming the protected resource metadata, so clients that support MCP authorization start the sign-in themselves.

Tools

Public (no account)

ToolWhat it does
estimate_self_employed_taxEstimate self-employed tax
check_tax_codeCheck a PAYE tax code
check_mtd_statusCheck if Making Tax Digital applies
get_mtd_deadlinesMaking Tax Digital deadlines
calculate_take_home_payCalculate take-home pay
calculate_gross_salary_for_take_homeWork out the salary for a take-home figure
calculate_salary_sacrificeCalculate salary sacrifice savings
calculate_pro_rata_salaryCalculate a pro rata salary
convert_hourly_rate_to_salaryConvert an hourly rate to a salary
convert_salary_to_hourly_rateConvert a salary to an hourly rate
calculate_student_loan_repaymentCalculate student loan repayments
calculate_child_benefit_chargeCalculate the High Income Child Benefit Charge
calculate_tax_on_multiple_incomesCalculate tax on several incomes
calculate_pension_tax_reliefCalculate pension tax relief
calculate_dividend_taxCalculate dividend tax
compare_salary_and_dividendsCompare salary and dividends
compare_limited_company_and_sole_traderCompare a limited company and sole trader
calculate_corporation_taxCalculate corporation tax
calculate_contractor_day_rateCalculate contractor day rate income
compare_inside_and_outside_ir35Compare inside and outside IR35
calculate_cis_deductionCalculate a CIS deduction
plan_quarterly_tax_set_asidePlan how much tax to set aside
calculate_mileage_allowanceCalculate the mileage allowance
estimate_self_assessment_penaltiesEstimate Self Assessment penalties
calculate_vatAdd or remove VAT
check_vat_registrationCheck VAT registration and the Flat Rate Scheme
check_vat_reverse_chargeCheck the construction VAT reverse charge
calculate_markupCalculate a price from a markup
calculate_profit_marginCalculate a profit margin
calculate_invoice_due_dateCalculate an invoice due date
calculate_late_payment_interestCalculate late payment interest on an invoice
calculate_capital_gains_taxCalculate Capital Gains Tax
calculate_rental_income_taxCalculate tax on rental income
calculate_savings_interest_taxCalculate tax on savings interest
calculate_stamp_dutyCalculate Stamp Duty
prepare_business_documentPrepare an invoice, quote or receipt to download
generate_invoice_numbersGenerate invoice numbers

Your TapTax account

ToolWhat it doesAccess
get_tax_positionGet my tax positionread
list_transactionsList my transactionsread
get_mileage_summaryGet my mileageread
add_transactionAdd income or an expenseread and change
update_transactionUpdate or review a transactionread and change
log_mileage_tripLog a business tripread and change
list_invoicesList my invoicesread
create_invoiceCreate an invoiceread and change
send_invoiceShow an invoice ready to sendread and change
mark_invoice_paidMark an invoice paidread and change
prepare_quarterly_updatePrepare my quarterly updateread
send_invoice_from_cardSend the invoice shown on the cardread and change

send_invoice_from_card is the Send button on the card that send_invoice shows. It is hidden from the assistant, so only your own press of Send can call it. Each card's button works once, within 15 minutes, and only while the invoice still matches what the card showed.

You sign in on taptax.co.uk and choose read-only or read-and-change access, and you can disconnect at any time in TapTax Settings > Connected apps.

What TapTax never does from a chat

  • File to HMRC. HMRC's fraud-prevention rules need details of the device you file from, so prepare_quarterly_update shows the figures with a button that opens TapTax on the right period, and the last tap is yours.
  • Email an invoice by itself. send_invoice shows the invoice in a card, and it is emailed only when you press Send on that card.
  • Move money or reveal bank or HMRC logins.

Estimates are not tax advice.

What the plugin contains and what it sends

The Claude Code plugin has two parts, and no code runs on your machine:

  • A skill (skills/taptax/SKILL.md): plain-text guidance that tells the assistant how to use the TapTax tools well.
  • A remote MCP server reference (.mcp.json): the HTTPS address of the TapTax server.

It has no hooks, commands, agents, scripts or local servers, and it installs no packages.

When the assistant calls a TapTax tool, the tool's inputs go over HTTPS to api.taptax.co.uk, the server TapTax runs, and nowhere else. The public tools need no account, and their inputs are the figures you ask about, such as a salary or a property price. The account tools work only after you sign in on taptax.co.uk, and they read or change your own TapTax records: transactions, mileage, invoices and your quarterly figures. An invoice is emailed to your client only when you press Send on the invoice card. TapTax handles this data under its privacy policy.

What is in this repository

PathPurpose
server.jsonThe Official MCP Registry entry
.claude-plugin/Claude Code plugin manifest and marketplace
.cursor-plugin/Cursor plugin manifest and marketplace
.mcp.json, mcp.jsonThe remote server for Claude Code and Cursor
skills/taptax/SKILL.mdGuidance the assistant loads with the plugin
glama.jsonGlama ownership claim

Support and privacy

TapTax is a trading name of HomePortfolio HQ Ltd.

No installation packages available.

Remote