Alpaca Trading API integration for Model Context Protocol (MCP)
DIY Accounting Submit is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Opens a book, derives VAT return figures and reads stored VAT receipts. Files no return.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user diy-accounting-submit-mcp '--' npx -y @diy-accounting-uk/diya-submit
# 2 — ask your agent for something these tools do
# sign_in, sign_out, open_book and 32 more
Remote: OAuth sign-in · Package: no sign-in.
DIY Accounting Submit costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. This one can run either way — at an address its publisher runs, or as a process under your own user, with your files and your network — and this marketplace is in the path of neither.
This is a public server: you run it yourself and this marketplace is not in the path. You need Node.js — the current LTS (24) is the safe choice; npx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. The '--' is in quotes so that PowerShell passes it on.
claude mcp add --scope user diy-accounting-submit-mcp '--' npx -y @diy-accounting-uk/diya-submitReconnect, or start a new session, and the tools appear in the model’s tool list.
Its publisher also runs it at https://submit.diyaccounting.co.uk/mcp: nothing to start on your machine, and this marketplace is not in the path.
claude mcp add --scope user --transport http diy-accounting-submit-mcp https://submit.diyaccounting.co.uk/mcpOne config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.
35 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Read from its source code. A server that builds its tool list when it starts can list more tools than this.
Sign in to DIY Accounting Submit as the MCP's own Cognito app client: opens the pool's hosted UI in the operator's browser (or prints the URL, when it cannot open one) with a PKCE code challenge, catches the authorization code on a loopback listener, and stores the refresh token under…
No parameter schema on file.
Ends the MCP's own session: revokes the refresh token at Cognito, tells DIY Accounting Submit's sign-out route to close it server-side too, then deletes the local credentials file. Best-effort on both network calls, so it still clears the local session when offline or the token is already expired.
No parameter schema on file.
Open a diya-gl book from the filesystem: a directory holding book.toml and lines.jsonl, or a single file (a DIY Accounting workbook, a package zip, a diya-gl zip, or a diya-gl JSON file). With cloud: true, opens bookId from the DIYA cloud instead (a practice client's own book with clientId),…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | no | Path to the book: a directory of book.toml + lines.jsonl, or one file the engine reads; unused with cloud |
| cloud | boolean | no | Open bookId from the DIYA cloud instead of the filesystem |
| bookId | string | no | The cloud book's id; required with cloud: true |
| clientId | string | no | A practice client's id, to open that client's book instead of the practice's own |
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. With clientId, lists that practice client's books instead of the practice's own.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clientId | string | no | A practice client's id, to list that client's books instead of the practice's own |
Save the session's loaded book to the filesystem. Formats: diya-gl-dir (book.toml + lines.jsonl into a directory; the default for a path with no extension), diya-gl-zip, json, xlsx (the product's recalculating workbook) and zip (the product's package). xlsx and zip fetch the template from…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | no | Where to write: a directory for diya-gl-dir, otherwise a file path; unused with cloud |
| format | string | no | One of diya-gl-dir, diya-gl-zip, json, xlsx, zip; unused with cloud |
| cloud | boolean | no | Save to the DIYA cloud by bookId instead of the filesystem |
| bookId | string | no | The cloud book's id; required with cloud: true |
| clientId | string | no | A practice client's id, to save into that client's book set |
Writes a diya-gl book and its lines as the unzipped spreadsheets package directory a completed year's package holds: one workbook for a single-file product (Basic Sole Trader, Taxi Driver), the whole named set for a multi-file one (Self Employed, Company), under outputDir in a directory named the…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| bookPath | string | no | Path to the book: a directory of book.toml + lines.jsonl, or one file the engine reads |
| book | object | no | A parsed book.toml, instead of bookPath |
| lines | array | no | Parsed lines.jsonl entries, instead of bookPath |
| templatePackagePath | string | no | The spreadsheets repository's app/ directory, read directly instead of fetching templates over the network |
| outputDir | string | yes | The directory the package's own named directory is written under |
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…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| periodEnd | string | yes | The obligation's period end, YYYY-MM-DD; must be a month end the book's VAT interface carries |
| periodStart | string | no | The obligation's period start, YYYY-MM-DD; refused unless it opens the quarter ending periodEnd |
| periodKey | string | no | The obligation's period key, echoed back for the submit call |
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…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| periodEnd | string | yes | The obligation's period end, YYYY-MM-DD; must be a month end the book's VAT interface carries |
| periodStart | string | no | The obligation's period start, YYYY-MM-DD; refused unless it opens the quarter ending periodEnd |
| periodKey | string | no | The obligation's period key |
The seven FRS 105 balance-sheet lines the accounts filing takes, from the session's loaded book: the current year from the engine's published balance sheet and the prior year from the book's opening balance, in whole pounds with capital and reserves equal to net assets, plus the period dates, the…
No parameter schema on file.
The figures a small company's FRS 102 section 1A accounts filing takes, from the session's loaded book: the full profit and loss account and the balance sheet sub-lines for the current year from the engine's published statements, the prior-year balance sheet from the opening balance, the tangible…
No parameter schema on file.
The figures the Company Tax Return form takes, from the session's loaded Company book: the accounting period, the computation figures (depreciation, amortisation, entertaining, capital allowances, franked investment income, losses brought forward), the profit and loss account from the engine's…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | no | Where to write the answer as JSON for the Company Tax Return page's import |
Answers HMRC's sign-in link for this session, so the VAT tools can call HMRC without a token in the chat. Answers {url, expiresAt, scope, hmrcAccount}: show the user the url, wait for them to say HMRC access is granted, then call list_vat_obligations or submit_vat_return. The link works once, for…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| services | array | no | — |
| hmrcAccount | string | no | Which HMRC environment: live (the default) or synthetic |
The open and fulfilled VAT obligations HMRC holds for one VRN, or for one practice client's VRN when clientId is given instead of vrn, over the deployed API. Uses the session's HMRC authorisation: call request_hmrc_authorisation first if this tool says none is held.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| vrn | string | no | VAT registration number, 9 digits; required unless clientId is given |
| clientId | string | no | A practice client's id, to resolve vrn from the client row instead |
| from | string | no | From date, YYYY-MM-DD; defaults to the start of the current calendar year |
| to | string | no | To date, YYYY-MM-DD; defaults to today |
| status | string | no | O (Open) or F (Fulfilled); both when omitted |
| hmrcAccount | string | no | Which HMRC environment to call; defaults to the session's HMRC authorisation's own |
| govTestScenario | string | no | HMRC sandbox test scenario |
What HMRC says the business owes for VAT, by period, for one VRN over the deployed API. Uses the session's HMRC authorisation: call request_hmrc_authorisation first if this tool says none is held.
No parameter schema on file.
The VAT payments HMRC has received from the business, by date, for one VRN over the deployed API. Uses the session's HMRC authorisation: call request_hmrc_authorisation first if this tool says none is held.
No parameter schema on file.
The VAT penalties and late-submission points HMRC holds for one VRN over the deployed API. Uses the session's HMRC authorisation: call request_hmrc_authorisation first if this tool says none is held.
No parameter schema on file.
One past VAT return as HMRC holds it, by its period key (the periodKey list_vat_obligations answers for a fulfilled obligation), over the deployed API. Use it to see what HMRC holds; to read Submit's stored copy of a return it filed, use get_vat_receipt. Uses the session's HMRC authorisation: call…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| vrn | string | yes | VAT registration number, 9 digits |
| periodKey | string | yes | The obligation's period key, for example 18A1 |
| hmrcAccount | yes | — | |
| govTestScenario | string | no | HMRC sandbox test scenario |
Files the nine VAT boxes the user has confirmed (derive_vat_return's hmrc fields) over the deployed API, for vatNumber or, when clientId is given instead, for that practice client's own VRN. Boxes 3 and 5 are HMRC's own totals and are not sent; the route derives them. Uses the session's HMRC…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| vatNumber | string | no | VAT registration number, 9 digits; required unless clientId is given |
| clientId | string | no | A practice client's id, to resolve vatNumber from the client row instead |
| periodStart | string | yes | The obligation's period start, YYYY-MM-DD |
| periodEnd | string | yes | The obligation's period end, YYYY-MM-DD |
| vatDueSales | number | yes | Box 1 |
| vatDueAcquisitions | number | yes | Box 2 |
| vatReclaimedCurrPeriod | number | yes | Box 4 |
| totalValueSalesExVAT | number | yes | Box 6 |
| totalValuePurchasesExVAT | number | yes | Box 7 |
| totalValueGoodsSuppliedExVAT | number | yes | Box 8 |
| totalAcquisitionsExVAT | number | yes | Box 9 |
| hmrcAccount | string | no | Which HMRC environment to call; defaults to the session's HMRC authorisation's own |
| govTestScenario | string | no | HMRC sandbox test scenario |
| runFraudPreventionHeaderValidation | boolean | no | — |
| allowSyntheticObligations | boolean | no | Synthetic only: file under any open obligation if the dates do not match |
A stored HMRC VAT receipt by its file name, over the deployed API: Submit's own copy of what it filed. To read HMRC's copy of a return by period key, use get_vat_return. clientId, when given, narrows the fetch to one of the practice's clients but does not change which receipt is read.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | The receipt file name, including .json (submit_vat_return answers receiptId without the suffix) |
| clientId | string | no | A practice client's id, to check the receipt belongs to that client |
The receipts Submit has stored for the signed-in account, the list its receipts page shows: each row carries the name get_vat_receipt takes. Use it to find a receipt this chat did not just file. clientId narrows the list to one of the practice's clients.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clientId | string | no | A practice client's id, to list that client's receipts |
The rendered FRS 105 micro-entity iXBRL for confirmed figures (derive_micro_entity_accounts' answer), over the deployed API. Never reaches the Companies House XML Gateway. The route never resolves a company from a practice client's row, so this tool takes companyNumber only, not clientId.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| registeredOffice | object | no | The registered office as address parts; taken from the company's Companies House record when left out |
| accountantsReport | object | no | Adds the accountants' report page and files the accounts as exempt from audit with an accountants' report |
| companyNumber | string | yes | The 8-character Companies House company number |
| companyName | string | yes | The registered company name |
| periodStart | string | yes | The accounting period's start date, YYYY-MM-DD |
| periodEnd | string | yes | The accounting period's end date, YYYY-MM-DD |
| balanceSheet | object | yes | The seven FRS 105 lines for the current and prior year, as derive_micro_entity_accounts answers them |
| averageEmployees | number | yes | The average number of employees in the period |
| director | object | yes | The signing director and the date the accounts were approved |
| statementsAccepted | object | yes | Every micro-entity exemption statement, confirmed true by the user before filing |
Files confirmed micro-entity accounts through the Companies House XML Gateway, over the deployed API, for companyNumber or, when clientId is given instead, for that practice client's own company number; returns the submission number. The company authentication code is not an argument: the user…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| companyNumber | no | Required unless clientId is given | |
| clientId | string | no | A practice client's id, to resolve companyNumber from the client row instead |
| codesEntryId | string | yes | The entryId request_companies_house_codes answered, once the user has typed the codes on its link |
The rendered FRS 102 section 1A small-company iXBRL for confirmed figures (derive_small_company_accounts' answer, with principalActivity and accountingPolicies added), over the deployed API. Never reaches the Companies House XML Gateway. The route never resolves a company from a practice client's…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| registeredOffice | object | no | The registered office as address parts; taken from the company's Companies House record when left out |
| accountantsReport | object | no | Adds the accountants' report page and files the accounts as exempt from audit with an accountants' report |
| companyNumber | string | yes | The 8-character Companies House company number |
| companyName | string | yes | The registered company name |
| periodStart | string | yes | The accounting period's start date, YYYY-MM-DD |
| periodEnd | string | yes | The accounting period's end date, YYYY-MM-DD |
| averageEmployees | number | yes | The average number of employees in the period |
| director | object | yes | The signing director and the date the accounts were approved |
| statementsAccepted | object | yes | Every small-company statement, confirmed true by the user before filing |
| smallCompany | object | yes | The figures and notes, as derive_small_company_accounts answers them plus principalActivity and accountingPolicies |
Files confirmed small-company accounts through the Companies House XML Gateway, over the deployed API, for companyNumber or, when clientId is given instead, for that practice client's own company number; returns the submission number. The company authentication code is not an argument: the user…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| companyNumber | no | Required unless clientId is given | |
| clientId | string | no | A practice client's id, to resolve companyNumber from the client row instead |
| codesEntryId | string | yes | The entryId request_companies_house_codes answered, once the user has typed the codes on its link |
Answers a link where the user types the Companies House codes a filing needs, so the codes never appear in the chat. Answers {entryId, url, expiresAt}: show the user the url, wait for them to say they have saved the codes, then pass entryId as codesEntryId to the filing tool. The link works for…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| kind | string | yes | Which filing the codes are for |
| companyNumber | string | no | The 8-character Companies House company number; required unless clientIds is given |
| clientIds | array | no | Practice client ids for a batch filing through run_for_clients: the page asks for one code per client |
| directors | array | no | Confirmation statement only: the directors in filing order; the page asks for one personal code each |
The register data a confirmation statement form is built from -- MadeUpDate, NextDueDate, SIC codes, RegisteredEmailAddress, officers, PSCs, StatementOfCapital, Shareholdings, TradingOnMarket, DTR5Applies, the PSC exemption flags, and whether the payment period is paid -- over the deployed API.…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| companyNumber | string | yes | The 8-character Companies House company number |
| codesEntryId | string | yes | The entryId request_companies_house_codes answered, once the user has typed the codes on its link |
| madeUpDate | string | yes | The confirmation statement's made-up date, YYYY-MM-DD |
| companyType | string | no | The company type, when the gateway needs it to resolve the request |
The rendered ConfirmationAndVerificationStatement body for confirmed answers, over the deployed API. Never reaches the Companies House XML Gateway; every director's personal code is masked in the rendered body before it leaves the route.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| companyNumber | string | yes | The 8-character Companies House company number |
| companyName | string | yes | The registered company name |
| dateSigned | string | yes | The date the statement is signed, YYYY-MM-DD |
| reviewDate | string | yes | The confirmation statement's review date, YYYY-MM-DD, not in the future |
| sicCodes | array | no | Up to 4 SIC codes; sent only when they have changed |
| statementOfCapital | object | no | Sent only when the statement of capital has changed |
| shareholdings | array | no | Sent only when Companies House requires it (a new shareholding, or on request) |
| registeredEmailAddress | string | no | Sent only when it has changed |
| lawfulPurposeStatementAccepted | boolean | yes | The user's confirmation that the company's intended future activities are lawful |
| stateConfirmationAccepted | boolean | yes | — |
| directors | array | yes | One verification statement row per current director |
Files a confirmed confirmation statement through the Companies House XML Gateway, over the deployed API; returns the submission number. The company authentication code and every director's personal code are not arguments: the user types them on the link request_companies_house_codes (kind…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| codesEntryId | string | yes | The entryId request_companies_house_codes answered, once the user has typed the codes on its link |
Accepted, rejected with reasons, or pending, for a submitted Companies House filing, over the deployed API. kind accounts is a micro-entity or small-company accounts filing (submit_micro_entity_accounts_sandbox, submit_small_company_accounts_sandbox); kind confirmation-statement is a confirmation…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| kind | string | yes | accounts or confirmation-statement |
| submissionNumber | string | yes | The 6-character submission number |
Move one of the practice's own books to a client's book set (during migration from sole trader to practice). Calls DIY Accounting Submit's own move route, which copies the book and every kept version, verifies each copy, then deletes the source. Refuses when the client already has a book with this…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clientId | string | yes | The client's id |
| bookId | string | yes | The book's id, one of the practice's own |
The signed-in practice's own client list over the deployed API: each client's id, display name, identifiers (VRN, NINO, UTR, company number) and current HMRC authorisation state per service. Archived clients are excluded.
No parameter schema on file.
Adds one client to the practice's list, over the deployed API. Every identifier is optional, but a given one must match its HMRC or Companies House format.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| displayName | string | yes | The client's name as the practice knows them, 1 to 200 characters |
| vrn | string | no | VAT registration number, 9 digits |
| nino | string | no | National Insurance number |
| utr | string | no | Unique Taxpayer Reference, 10 digits |
| companyNumber | string | no | Companies House company number, 8 characters |
Sends an HMRC Agent Authorisation invitation for one client and one service, over the deployed API. The client's own VRN or NINO comes from the client row, not from this call. Uses the session's HMRC authorisation: call request_hmrc_authorisation with services agent first if this tool says none is…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clientId | string | yes | The client's id |
| service | string | yes | The HMRC service to request authorisation for |
| knownFact | string | yes | The VAT registration date (MTD-VAT) or the client's postcode (MTD-IT) |
| arn | string | no | The practice's HMRC agent reference number; stored for reuse when given, read back when omitted |
One client's current authorisation status for one HMRC service, over the deployed API: re-reads a pending invitation's own status, or HMRC's relationships endpoint when none is pending. Uses the session's HMRC authorisation: call request_hmrc_authorisation with services agent first if this tool…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| clientId | string | yes | The client's id |
| service | string | yes | The HMRC service to check |
Runs one client-scoped tool once per client in the practice's own list (list_clients), passing each client's clientId in turn. Returns one row per client -- {clientId, displayName, ok, result or error} -- plus a summary count; one client's failure never stops the rest. tool is one of…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tool | string | yes | The client-scoped tool to run for every client |
| args | object | no | That tool's other arguments; clientId is added per client and overrides any given here |
- Every tool, no call limit
- No card, and mcprush charges nothing for it
- Source published under LicenseRef-PolyForm-Internal-Use-1.0.0
- Runs on your machine — nothing of it reaches our gateway
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install DIY Accounting Submit or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | high | capability blast radius (high) — client exposure if the model is manipulated | −6 |
| verification-discount | source | publisher verification (provenance) — cryptographic build provenance ties the artifact to its source | −0 |
| coverage-honesty | source | inspection depth (source) — how much of the target the scan could see | −0 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
No tools were enumerated, so prompt-injection, capability and toxic-flow analysis had no tool surface to inspect. To grade a package’s real runtime tools, scan the running server: --command "npx -y <package>".
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. high is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| No per-tool rows for this release — see the note below. | ||
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
Always latest — the install command names no version, so it installs the newest release when it runs; the current release on file is 0.1.4. Pin a release below and the command asks for exactly that one.
No release note was published with this version.
- The version this listing was on when mcprush began following its releases. The registry was not asked when it shipped, so this row carries no date.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish DIY Accounting Submit can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.