Automate UAE Corporate Tax Registration on EmaraTax with an AI Agent

What the UAE Corporate Tax Registration Skill Does

The UAE Corporate Tax Registration Skill is an open-source set of instructions that helps a browser-capable AI agent complete a Corporate Tax registration through the Federal Tax Authority's EmaraTax portal. You provide the company information, documents, and directions; the agent handles the repetitive clicking, typing, and file uploads.

The skill covers the main stages of the application, including creation of the Taxable Person profile, entity and trade licence details, business activities, ownership information, the authorised signatory, and contact details. It also guides the agent through several portal-specific issues that can make the form difficult to complete.

Important: This project is an automation aid, not tax, legal, accounting, or financial advice. It does not determine what your company should report. You remain responsible for every answer, document, declaration, and submission.

Key Features and Safety Boundaries

What the agent can handle

• Navigate the EmaraTax Corporate Tax registration workflow step by step.
• Extract relevant information from documents you provide.
• Ask for missing details, such as a mobile number or email address.
• Enter company, licence, activity, owner, signatory, and contact information.
• Upload supporting PDFs to the appropriate fields.
• Account for the SAP file uploader, mandatory landline field, Emirates ID validation, and automatically calculated first tax period.
• Stop at the review and legal declaration stage.

What the agent will not do

• It will not enter your password or one-time password. You must log in yourself.
• It will not select the legal declaration.
• It will not submit the registration application.
• It will not decide your tax position or recommend reliefs.
• It will not continue if EmaraTax warns that the licence is already registered under another account.

These limits ensure that authentication and the legally significant submission decision remain under your control.

Who the Skill Is For

The repository is intended for UAE mainland and free zone companies that need to register for Corporate Tax and want help completing the online form. According to the project documentation, new companies must register within three months of incorporation, and late registration can result in an AED 10,000 penalty.

If you are unsure whether your company must register, what information is correct, or whether a tax treatment or relief applies, consult a registered UAE tax agent or another qualified professional before using the skill.

Requirements

Before starting, make sure you have the following:

• A browser-capable AI agent, such as Claude Code with browser or computer tools, OpenAI Codex, or an equivalent agent with screen control.
• An EmaraTax account. You can create one through the EmaraTax e-services portal.
• Your trade licence, certificate of incorporation, memorandum of association, and relevant identification documents as PDFs.
• The Emirates ID and passport of the owner and authorised signatory.
• Your licence number, incorporation date, business activities, owner details, mobile number, email address, and other company contact information.

Use references/before-you-start.md as the full preparation checklist. Gathering everything first reduces interruptions while the agent is navigating the portal.

Repository Files

The repository separates the agent instructions from the supporting documentation:

• SKILL.md contains the instructions the AI agent follows.
• references/before-you-start.md lists the documents and information to prepare.
• references/emaratax-walkthrough.md provides a field-by-field walkthrough of the five registration steps.
• references/gotchas.md documents common portal problems and how to handle them.

Installation and Setup

Step 1: Obtain the repository

Download or clone the project so that your AI agent can access SKILL.md and the reference files. Keep the repository files together because the skill relies on the supporting checklists and walkthroughs.

Step 2: Choose how to load the skill

For Claude Code, place the project folder in your configured skills directory so that the skill can load automatically. Alternatively, open SKILL.md, paste its contents into the agent conversation, and tell the agent what you want to do.

A basic prompt can be:

Help me register for UAE Corporate Tax on EmaraTax. I am logged in. Follow SKILL.md, ask me for missing information, and stop before the legal declaration and submission.

For OpenAI Codex or another compatible agent, provide access to the repository instructions and ensure that the agent has the browser or computer-control capability required to operate EmaraTax.

Step 3: Prepare a secure working session

Open the EmaraTax portal in the browser that the agent will control. Avoid placing passwords or one-time passwords in the chat, documents, or prompt. Authentication is a manual step.

Step-by-Step Basic Usage

1. Complete the preparation checklist

Open references/before-you-start.md and confirm that all required PDFs and company details are available. Check that scans are readable and that the names, dates, identification numbers, and licence details are consistent.

2. Log in to EmaraTax yourself

Go to the EmaraTax portal, enter your own credentials, and complete any one-time-password challenge. Do not ask the agent to type or store these credentials.

3. Start the guided registration

Tell the agent that you are logged in and ready. The agent should follow SKILL.md and guide the registration through the Taxable Person profile and the remaining Corporate Tax sections.

You can use a concise instruction such as:

I am logged in to EmaraTax. Use the UAE Corporate Tax Registration Skill to complete the form with the documents I provide. Ask before entering anything uncertain, and do not accept the declaration or submit.

4. Answer questions and confirm extracted data

The agent may read details from your PDFs and ask for information that is unavailable or ambiguous. Compare every extracted value with the original document before confirming it. Pay particular attention to licence numbers, incorporation dates, legal names, Emirates ID details, and authorised signatory information.

5. Monitor document uploads

The EmaraTax SAP uploader may appear to accept a file while silently dropping it. After each upload, verify that the expected filename or attachment indicator remains visible in the correct field. Do not assume an upload succeeded merely because the file picker closed.

6. Review the completed application

The agent must stop before the final legal declaration. Review every section on the EmaraTax review screen against your original documents and source information. Correct any missing, inconsistent, or unexpected value before proceeding.

7. Declare and submit manually

Only the responsible person should select the legal declaration and submit the application. The authorised signatory is making a legal declaration to the Federal Tax Authority; the AI agent and the project author are not making it on the company's behalf.

Handling Common EmaraTax Issues

Files disappear after upload

Check each document field after using the uploader. If a file is no longer shown, follow the repository's references/gotchas.md guidance and upload it again rather than moving forward with an empty attachment field.

The form requires a landline number

The registration workflow includes a mandatory landline field. Have the company's correct contact information available and let the agent ask you for any value that is not present in the supplied documents. Do not invent a number simply to pass validation.

Emirates ID validation fails

Compare the entered Emirates ID details with the original identification document. Check for transcription mistakes and ensure that related personal information is consistent. If the correct information still does not validate, stop and investigate rather than asking the agent to guess.

The first tax period is calculated automatically

EmaraTax may calculate the first tax period from the supplied company data. Treat this as a value that requires review. The skill does not provide tax advice or decide whether the displayed period is correct for your circumstances.

The licence is already registered

If the portal warns that the trade licence is associated with another account, the skill is designed to stop. Do not attempt to bypass the warning. Resolve the account or registration issue through the appropriate official channel before continuing.

Advanced Tips for a Safer Session

1. Use a dedicated document folder. Keep only the relevant PDFs in the working directory so the agent can identify the correct files more easily.
2. Review section by section. Do not wait until the final screen to check the data. Confirm each completed section against the source documents.
3. Ask the agent to pause on uncertainty. Explicitly instruct it not to infer missing legal, ownership, or tax information.
4. Keep credentials outside the conversation. Enter passwords and OTPs manually even if the browser is already under agent control.
5. Verify upload persistence. Recheck attachments after navigating between sections because the uploader may silently discard files.
6. Use the detailed walkthrough. Consult references/emaratax-walkthrough.md when a field label or registration step is unclear.
7. Use the gotchas reference before retrying. Review references/gotchas.md when validation or upload behavior is unexpected.
8. Save evidence of what you submitted. Use the options available in EmaraTax to retain your own records, while ensuring that sensitive company and identity information is stored securely.

After Submission

The README states that approval usually takes 5 to 20 business days, although processing time is not guaranteed. The project author reports receiving a Tax Registration Number on the same day, but individual applications may take longer or require follow-up.

Monitor your EmaraTax account and registered contact channels for status updates or requests for additional information.

Legal and Professional Responsibility

The project is provided under the MIT licence, as is and without warranty. It is not affiliated with or endorsed by the Federal Tax Authority, the UAE government, EmaraTax, any free zone authority, Anthropic, or OpenAI.

You are responsible for the accuracy of the application and any consequences arising from its submission. For questions about Corporate Tax, VAT, free zone status, reliefs, or your company's specific tax position, consult a registered UAE tax agent. The FTA publishes relevant information through tax.gov.ae.

Conclusion

The UAE Corporate Tax Registration Skill turns a manual EmaraTax workflow into an agent-assisted process while preserving human control over authentication, factual decisions, the legal declaration, and final submission. Prepare complete documents, monitor every field and upload, stop whenever information is uncertain, and perform a careful final review before submitting.