DIY Accounting Submit

● Active

io.github.diy-accounting-uk/diya-submit

Opens a book, derives VAT return figures and reads stored VAT receipts. Files no return.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "diya-submit": {
      "command": "npx",
      "args": [
        "-y",
        "@diy-accounting-uk/diya-submit@0.1.4"
      ]
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add diya-submit -- npx -y @diy-accounting-uk/diya-submit@0.1.4
OpenAI Codex CLI
codex mcp add diya-submit -- npx -y @diy-accounting-uk/diya-submit@0.1.4
VS Code
code --add-mcp '{"name":"diya-submit","type":"stdio","command":"npx","args":["-y","@diy-accounting-uk/diya-submit@0.1.4"]}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Finance
Version
0.1.4
Registry
active
Published
11/18/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Mostly fine: DIY Accounting Submit is maintained, hosted endpoint answering without a key.

Maintained
Active
Last commit today (Nov 21, 2026), 2 open issues.
Official registry
Active
Published as io.github.diy-accounting-uk/diya-submit in the official MCP registry, version 0.1.4.
Source
No licence found
Public repository, but GitHub reports no recognised licence (0 stars). Check the README before shipping it in a product.
Runs
Local package or hosted
Ships as a local package (npm) that runs on your machine, and as a hosted endpoint at submit.diyaccounting.co.uk that receives what your client sends it.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 02:09 UTCStatus history & uptime →
● Working576 msprotocol 2025-06-18v0.1.4toolsresources

The endpoint answered the MCP handshake as "diya-submit" and listed 6 tools. Answering since Nov 18, 2026.

Context cost ≈ 1.4k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 6 tools.

Tools (6)

  • list_books1 param

    List the books saved in the DIYA cloud, most recently updated first, signed in as the session's credentials. Each row carries the bookId open_book takes, the book's title, its product and the period it covers. With clientId, lists that practice client's books instead of the practice's own.

    Show parameters
    • clientIdstringA practice client's id, to list that client's books instead of the practice's own
  • open_book2 params

    Open a book saved in the DIYA cloud by bookId (a practice client's own book with clientId), signed in as the caller. Answers the product, the entity, the period covered, the line count and the book checks summary. Replaces the session's loaded book.

    Show parameters
    • bookIdstringrequiredThe cloud book's id
    • clientIdstringA practice client's id, to open that client's book instead of the practice's own
  • derive_vat_return3 params

    The nine VAT boxes for one obligation period from the session's loaded book, read from the engine's own VAT interface: the quarter ending on periodEnd (a month end the book carries), with HMRC's field names and rounding, the three months' figures, and every sales and purchases journal line that fed boxes 1, 4, 6 and 7. Refuses a book that is not VAT registered, a period the book does not carry, and a period whose lines do not reconcile with the interface.

    Show parameters
    • periodEndstringrequiredThe obligation's period end, YYYY-MM-DD; must be a month end the book's VAT interface carries
    • periodStartstringThe obligation's period start, YYYY-MM-DD; refused unless it opens the quarter ending periodEnd
    • periodKeystringThe obligation's period key, echoed back for the submit call
  • prepare_vat_return3 params

    Derives the VAT return for the quarter ending on periodEnd from the session's loaded book, exactly as derive_vat_return does, and answers a link to the VAT form on the Submit site with the seven figures filled in (the form works out boxes 3 and 5 itself). This tool never files anything and reaches no outside service. The person opens the link, checks the figures on the page, ticks the declaration and files there; the figures filed are the figures the page shows.

    Show parameters
    • periodEndstringrequiredThe obligation's period end, YYYY-MM-DD; must be a month end the book's VAT interface carries
    • periodStartstringThe obligation's period start, YYYY-MM-DD; refused unless it opens the quarter ending periodEnd
    • periodKeystringThe obligation's period key
  • get_vat_receipt2 params

    A stored VAT return receipt by its file name, over the deployed API: what HMRC answered when it accepted the return (the processing date, the form bundle number, the payment indicator and the charge reference). clientId, when given, narrows the fetch to one of the practice's clients but does not change which receipt is read.

    Show parameters
    • namestringrequiredThe receipt file name, including .json (submit_vat_return answers receiptId without the suffix)
    • clientIdstringA practice client's id, to check the receipt belongs to that client
  • list_vat_receipts1 param

    The VAT return receipts Submit has stored for the signed-in account, newest first: each row carries the name get_vat_receipt takes, HMRC's form bundle number and the day the return was filed. clientId narrows the list to one of the practice's clients.

    Show parameters
    • clientIdstringA practice client's id, to list that client's receipts

Checked by Serverdex with a plain initialize + tools/list call to submit.diyaccounting.co.uk/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 21, 2026
Stars
0
Forks
2
Last push
Nov 21, 2026
License
Other

JavaScript

From the README

DIY Accounting Submit™ HMRC recognised software for Making Tax Digital VAT submissions Submit UK VAT returns to HMRC using the official Making Tax Digital (MTD) APIs. Website: https://submit.diyaccounting.co.uk Status: Production What is DIY Accounting Submit? DIY Accounting Submit is a free web application that enables UK VAT-registered businesses to: • View VAT obligations - See your outstanding and fulfilled VAT periods • Submit VAT returns - File your VAT return directly to HMRC • View submission receipts - Access confirmation of submitted returns • Track submission history - Keep records for 7 years (HMRC requirement) The software connects directly to HMRC's official MTD APIs and implements all required fraud prevention measures. Key Features How It Works 1. Sign in with Google (via AWS Cognito) 2. Authorise the application through HMRC's secure OAuth flow 3. Enter your VAT return figures 4. Submit directly to HMRC 5. Receive confirmation and receipt Your HMRC Government Gateway credentials are never stored by this application.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://submit.diyaccounting.co.uk/mcp

The most-starred Finance servers in the index, with their live-check result.

ServerStarsLast pushLive check
CCXT44,949Nov 2026Local / not checked
QR Rápido7,477Nov 2026Needs sign-in
Finance Toolkit5,554Nov 2026Needs sign-in
AKQuant2,627Nov 2026Local / not checked
com.stripe MCP2,072Nov 2026Needs sign-in

DIY Accounting Submit: questions people ask

Is DIY Accounting Submit a remote or a local MCP server?
According to its entry in the official MCP registry, DIY Accounting Submit ships as a hosted endpoint (streamable-http) that your client connects to by URL and as a local package (npm) that your client starts on your machine. Use the hosted endpoint when your client supports Streamable HTTP; use the package when you want it to run locally.
Does DIY Accounting Submit need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is DIY Accounting Submit safe to use?
Mostly fine: DIY Accounting Submit is maintained, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: No licence found; runs: Local package or hosted; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is DIY Accounting Submit still maintained?
Active: the repository's last commit today. Last push Nov 21, 2026, 0 GitHub stars, Other licence. Read from GitHub on Nov 21, 2026.
What tools does DIY Accounting Submit expose?
6 tools as listed by the server itself during the live check, including list_books, open_book, derive_vat_return, prepare_vat_return, get_vat_receipt. The full list with parameters is in the Live check section above.
How do I add DIY Accounting Submit to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Finance →

Add the badge to your site

Show visitors that DIY Accounting Submit is listed here — it’s also the link we check for a free listing.

DIY Accounting Submit — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-diy-accounting-uk-diya-submit?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="DIY Accounting Submit — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![DIY Accounting Submit — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-diy-accounting-uk-diya-submit?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-diy-accounting-uk-diya-submit) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-diy-accounting-uk-diya-submit) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-diy-accounting-uk-diya-submit)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-diy-accounting-uk-diya-submit"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-diy-accounting-uk-diya-submit"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-diy-accounting-uk-diya-submit"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).