Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

DIY Accounting Submit

von diy-accounting-ukVersion 0.1.4i★ 0iComputer oder CloudOffizielle Website ↗
Name in der Registryio.github.diy-accounting-uk/diya-submit

So installierst du es

What it does

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

  • Connects Computer oder Cloud
  • Account or key No key needed
  • Category Buchhaltung, Finanzen & Steuern

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert20/100

Qualität: 4/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte DIY Accounting Submit. Folge https://mcp.popnx.com/i/diy-accounting-uk-diya-submit.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (submit.diyaccounting.co.uk) · ✓ Befehle geprüft am 19. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameDIY Accounting Submit
    Remote MCP server URL · Adressehttps://submit.diyaccounting.co.uk/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsDIY Accounting Submit

  4. Ausprobieren

    Nutze DIY Accounting Submit und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es DIY Accounting Submit nutzt, oder ein Werkzeug von DIY Accounting Submit in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameDIY Accounting Submit
    Connection · Adressehttps://submit.diyaccounting.co.uk/mcp
  3. DIY Accounting Submit im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen DIY Accounting Submit aus deinen Plugins wählen

  4. Ausprobieren

    Nutze DIY Accounting Submit und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es DIY Accounting Submit nutzt, oder ein Werkzeug von DIY Accounting Submit in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user diya-submit https://submit.diyaccounting.co.uk/mcp
  3. /mcp in Claude Code eingeben

    DIY Accounting Submit sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze DIY Accounting Submit und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es DIY Accounting Submit nutzt, oder ein Werkzeug von DIY Accounting Submit in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze DIY Accounting Submit und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es DIY Accounting Submit nutzt, oder ein Werkzeug von DIY Accounting Submit in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze DIY Accounting Submit und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es DIY Accounting Submit nutzt, oder ein Werkzeug von DIY Accounting Submit in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://submit.diyaccounting.co.uk/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die DIY Accounting Submit nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user diya-submit https://submit.diyaccounting.co.uk/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "diya-submit": {
      "url": "https://submit.diyaccounting.co.uk/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "diya-submit": {
      "type": "http",
      "url": "https://submit.diyaccounting.co.uk/mcp"
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user diya-submit -- npx -y @diy-accounting-uk/diya-submit

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "diya-submit": {
      "command": "npx",
      "args": [
        "-y",
        "@diy-accounting-uk/diya-submit"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "diya-submit": {
      "command": "npx",
      "args": [
        "-y",
        "@diy-accounting-uk/diya-submit"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "diya-submit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@diy-accounting-uk/diya-submit"
      ]
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
82/Wo.
Lizenzi
Keine Lizenz angegeben
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.1.4
In der Registry veröffentlichti
19. Nov. 2026
Code zuletzt geänderti
19. Nov. 2026
Zuletzt geprüft
19. Nov. 2026
Entwickler
diy-accounting-uk
Pakete
npm: @diy-accounting-uk/diya-submit
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 19. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • list_books

    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 pract

  • open_book

    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.

  • derive_vat_return

    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 jo

  • prepare_vat_return

    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 an

  • get_vat_receipt

    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 clie

  • list_vat_receipts

    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.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto diy-accounting-uk bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: gestern

  • ! Vorsicht

    Hat eine Lizenz

    GitHub konnte die Lizenzart nicht erkennen; öffne die Datei, um nachzusehen

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 589 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 6 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Veröffentlichte Schwachstellen (OSV.dev)

Noch nicht geprüft

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/diy-accounting-uk-diya-submit.svg)](https://mcp.popnx.com/en/servers/diy-accounting-uk-diya-submit)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

  • Mehr Sterne als 0 % der anderen 3448 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 97 % der anderen 3448 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 60 % der anderen 3448 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist DIY Accounting Submit sicher?

Er hat 4 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (0.1.4) kam gestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

von SolidInvoiceWachsend★ 991Aktualisiert vor 11 Tagen

Läuft in der Cloud✓ vom Dienst · solidinvoice.co

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

von signal8aiWachsend↓ 431/Wo.★ 425Aktualisiert vor 11 Tagen

Computer oder Cloud✓ vom Dienst · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

von CursivezWachsend★ 261Aktualisiert vor 12 Tagen

Läuft in der Cloud✓ vom Dienst · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

von bex-coWachsend★ 702 Sterne des ganzen ReposAktualisiert letzten Monat

Läuft in der Cloud✓ vom Dienst · beancount.io
Im Vergleich mit ähnlichen
Dieser
DIY Accounting Submit
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem Rechner
Braucht SchlüsselNeinNeinJaNeinNeinJa
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen4/54/65/54/44/45/5
LizenzNOASSERTIONMITMITNOASSERTIONMITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

@diy-accounting-uk/diya-submit

The submission MCP for DIY Accounting Submit (../private.diyaccounting.co.uk/engineering/submit/archive/PLAN_SUBMISSION_MCP.md). It opens a customer's books with the published @diy-accounting-uk/diya-gl engine, derives the figures a filing needs, and drives the VAT return and the micro-entity accounts through this service's endpoints. This package is the skeleton: the server, the stdio transport and the two book tools. The derivation and filing tools are the plan's later rows.

Run

npm --prefix mcp install

node mcp/bin/diya-submit-mcp.js

Point an MCP client at that command with no arguments. The server is mcp/lib/server.js; the stdio entry point only connects it to stdin and stdout, so the hosted transport connects the same server to a different one.

Hosted

The same server runs behind the site at /mcp, for chat clients that connect by URL. Add https://submit.diyaccounting.co.uk/mcp as a custom connector in Claude (web, Desktop, mobile or Cowork), or in Claude Code:

claude mcp add --transport http diya-submit https://submit.diyaccounting.co.uk/mcp

The endpoint answers initialize, ping and tools/list without a token, so a client or a catalogue can read the tools first. The first tool call without a token gets 401 with a WWW-Authenticate challenge. The client finds the sign-in through /.well-known/oauth-protected-resource/mcp, registers itself, and the user signs in with their Submit account. The ci form of the URL is https://ci-submit.diyaccounting.co.uk/mcp. The hosted tool set is HOSTED_TOOL_NAMES in lib/hosted-tools.js: open_book reads the DIYA cloud only. The sign-in pair, the filesystem tools, the practice tools that still take an HMRC token, and run_for_clients are not registered.

HMRC fraud prevention data

HMRC requires data about the device behind each request. The two surfaces send different data.

  • The stdio server is DESKTOP_APP_VIA_SERVER. On each call to an HMRC route it reads a device id (kept in ~/.config/diya-submit/device-id), the local IP addresses, the MAC addresses, the operating system user, the timezone, the operating system and device model, and the screens. It has no window, so it sends no Gov-Client-Window-Size.
  • The hosted endpoint is OTHER_VIA_SERVER. It passes the public address of the caller at /mcp, signed so that Submit can trust it. An AI client gives no device data.

Tools

ToolDoes
open_bookLoads a book from a path: a directory of book.toml + lines.jsonl, or one file the engine reads (a workbook, a package zip, a diya-gl zip, a diya-gl JSON file). Answers the product, entity, period, line count and the book checks summary.
save_bookWrites the session's book to a path as diya-gl-dir, diya-gl-zip, json, xlsx or zip. The last two compose the product's workbook from the site's templates.
derive_itsa_quarterly_updateOne period of HMRC's Self Employment Business API from a self-employed book: the period's own figures in a tax year filed as dated period summaries, the running total from 6 April in a year filed as cumulative period summaries (2025-26 on). periodEndDate picks the period; quarterlyPeriodType is standard or calendar. A field the book cannot source is omitted, never sent as zero.
derive_itsa_annual_submissionThe year's allowances and adjustments for the annual submission, restricted to the fields HMRC accepts for that tax year (sa103-mtd-mapping.json's api.years). With path, also written as the JSON file the site's annual submission page imports.
request_hmrc_authorisationHMRC's sign-in link for this session. services is vat (the default) and itsa; hmrcAccount is live (the default) or synthetic. Answers url, expiresAt, scope, hmrcAccount. The user grants access on HMRC's pages; Submit keeps HMRC's tokens and renews the access token for the rest of the session. No token reaches the chat.
list_vat_obligationsVAT obligations for vrn (or clientId), filtered by from, to, status. Uses the session's HMRC authorisation; optional hmrcAccount (the authorisation's own by default), govTestScenario.
submit_vat_returnFiles the seven confirmed boxes (vatDueSales, vatDueAcquisitions, vatReclaimedCurrPeriod, totalValueSalesExVAT, totalValuePurchasesExVAT, totalValueGoodsSuppliedExVAT, totalAcquisitionsExVAT) for periodStart to periodEnd, for vatNumber or clientId. Uses the session's HMRC authorisation. Answers receipt, periodKey, receiptId.
get_vat_receiptA stored VAT return receipt by name ( .json); optional clientId. Answers HMRC's processingDate, formBundleNumber, paymentIndicator and chargeRefNumber.
render_micro_entity_accounts_sandboxThe rendered micro-entity iXBRL for confirmed figures, without reaching the Companies House gateway. Inputs: companyNumber, companyName, periodStart, periodEnd, balanceSheet, averageEmployees, director, statementsAccepted.
render_small_company_accounts_sandboxThe rendered small-company (FRS 102 section 1A) iXBRL for confirmed figures, without reaching the gateway. Inputs: companyNumber, companyName, periodStart, periodEnd, averageEmployees, director, statementsAccepted (four small-company statements) and smallCompany (filleted, principalActivity, accountingPolicies, directors, balanceSheet, profitAndLoss, fixedAssetNote).
request_companies_house_codesA link where the user types the Companies House codes instead of the chat. kind is accounts, confirmation-statement (with directors in filing order) or confirmation-statement-data; answers entryId, url, expiresAt. The entry lasts ten minutes and one filing call uses it up. With clientIds (no companyNumber) the page asks for one code per practice client and each client's filing call, including through run_for_clients, takes only its own.
submit_micro_entity_accounts_sandboxFiles the same figures with the codes the user typed on that link, named by codesEntryId; answers submissionNumber.
submit_small_company_accounts_sandboxFiles the small-company figures with the codes named by codesEntryId, for companyNumber or clientId; answers submissionNumber. Poll it with poll_submission kind accounts.
poll_submissionThe outcome of a Companies House filing, kind accounts or confirmation-statement, for a submissionNumber: PENDING, ACCEPT (with receiptId) or REJECT (with rejections).

The filing tools call the deployed REST API at DIYA_SUBMIT_BASE_URL with the MCP's own sign-in bearer (sign_in), and poll a 202 answer to its terminal status. They validate required inputs before any request.

One book per session, in memory. open_book replaces it. The two ITSA tools live in lib/itsa-tools.js and register through registerItsaTools(server, session).

Test

npm --prefix mcp test

npm --prefix mcp run test:system

test:system starts npm run start:simulator from the repository root, grants a bundle, starts an HMRC grant with request_hmrc_authorisation and completes it as the callback page would, then runs list_vat_obligations, submit_vat_return and get_vat_receipt against it, using whichever open obligation the simulator answers. npm run test:mcpHmrcGrantBehaviour-simulator (from the repository root) walks the same grant through HMRC's consent pages in a browser. The design is in ../../private.diyaccounting.co.uk/engineering/submit/archive/PLAN_MCP.md.

The tests open the BrickWork Pro Ltd and Precision Code Ltd example books under test/fixtures/ (copies of the spreadsheets repository's examples/) and round-trip each through the three formats that need no template; the ITSA tests open the BrickWork Pro self-employed VAT book (examples/brickwork-pro/se-vat) and check the quarterly running totals and the annual field set by tax year.