Cyprus VAT return

What it does

Drop in the period’s bills and invoices. Claude reads each one into a list, and the skill places it in its boxes by fixed rules. A document the rules cannot place is a question, never a guess.

VAT that cannot be claimed is listed with its reason. A bill that is not the company’s is left out. The draft is written once you have said the documents are complete, because documents cannot show what is missing.

The draft then feeds the same tests, the VIES files and the XML for Tax For All. It is a draft for you or your accountant to read before anything is uploaded.

It also reviews a return you already have, box by box, and looks EU VAT numbers up in the EU’s VIES service. It writes no file while a test that stops it is open, and reads each built file back to test it against the Tax Department’s published schema.

Four sets of tests

45 tests in all, each with its own code.

A draft from documents, PD-01 to PD-08

8 tests

The thirteen boxes, VR-01 to VR-17

17 tests

The lines behind a return, VL-01 to VL-12

12 tests

A monthly VIES statement, VS-01 to VS-08

8 tests

Two files for Tax For All

The VAT return

Built from the draft, or from the thirteen figures of a return you give it.

The monthly VIES statement

Built from the month’s sales to customers in other EU countries.

What a draft means

A draft is for you or your accountant to read before anything is uploaded. The skill does not advise on tax and does not keep your books.

A built file passed the tests of this skill and the published schema. It means no more than that. The skill files nothing: you upload the file in Tax For All yourself.

Cyprus only

It works on Cyprus VAT returns and VIES statements only. It builds no One Stop Shop return and no payroll returns.

The Tax Department’s guide is quoted in the skill, not shipped with it.

What it reads

The period’s bills and invoices. Claude reads each one into a list; the script places the rows in their boxes and builds the files.

Or the thirteen figures of a return from any accounting software, to review it box by box and build its file.

Try “Here are my bills and invoices for July to September 2026. Prepare a draft VAT return.”

Connected to Cybooks

Reads the live return in Cybooks. The XML file then comes from Cybooks itself, and the skill reviews the return.

What you need

Claude, with skills

Anthropic offers skills on its Free, Pro, Max, Ultra, Team and Enterprise plans. To add this one, open Customize › Skills, press +, then Create skill › Upload a skill, and pick its file.

Code execution

Turn on Code execution and file creation in Settings › Capabilities, or use Claude Code. Claude reads any documents into a list. Placing each row in its boxes, and every test, is done by code with fixed rules.

On its own

The period’s bills and invoices, or the thirteen figures of a return from any accounting software.

Connected

The Cybooks connector at https://app.cybooks.com.cy/mcp/cybooks, signed in. It reads with your own permissions. The connector is on Premium.

Python

Python 3.9 or later where the code runs.

Schema test

lxml or xmllint where the code runs. Without either, the output says the schema was not run.

VAT number lookup

Network access to ec.europa.eu.

Or install from a terminal

Licence

Its text and code are under the MIT licence (Copyright (c) 2026 Cybooks Ltd).

The Tax Department’s four schema files inside it are not under the MIT licence. They are the Ministry of Finance’s, included unchanged, as the skill’s LICENSE.txt says.

How it was tested

Tested with 82 script tests in the pack. One independent review and three code reviews were made, and every finding was applied.

The review was run end to end in two rounds, on a made-up quarter with planted mistakes: each one was found, and no file was built. The same quarter put right built four files, and they passed the published schema.

A draft from documents was run twice by a fresh Claude session, on 18 generated PDF invoices and bills. One run held the draft on two open questions. The other went from the PDFs to the draft, the July VIES file and the VAT return XML, and both files passed the published schema.

Not yet tested: an upload to Tax For All, a run inside the Claude apps, scanned or photographed documents (the test PDFs carried real text), the connected path against the live Cybooks connector, a schema test with lxml, and the terminal install.