Home

Help: step by step

Your federal and Massachusetts return. Do the steps in order, one thing each.

How it works

  1. This site does all the tax math.
  2. Your AI can do the typing (Gemini, Claude or ChatGPT). Or type it all yourself.
  3. You check every number here and confirm it. The AI never decides anything.
  4. You sign, print and mail. Nothing is sent to the IRS or Massachusetts for you.
What it handles today. Tax years 2023, 2024 and 2025. Massachusetts residents who lived here all year, filing single, head of household, qualifying surviving spouse or married (jointly or separately), with W-2s, bank interest and dividends (1099-INT, 1099-DIV), self-employment income (1099-NEC), up to 4 dependents (the child tax credit and the Massachusetts Child and Family Tax Credit) and the child and dependent care credit. It fills in the Massachusetts health coverage schedule (Schedule HC) when everyone on the return was covered all year. Not yet: stock sales (1099-B), capital gain distributions, retirement payouts (1099-R), unemployment (1099-G), HSA (1099-SA), 1099-K, mortgage or student-loan interest (1098), tuition (1098-T), Social Security (SSA-1099) and marketplace coverage (1095-A). The earned income credit (federal and Massachusetts) is worked out when you qualify; a few situations stop it for now (a child not on your People page, no Social Security number for a child, Form 2555, or a credit denied in a past year). If your return needs something it can't do, it says so and stops. It never guesses.

Have ready: your W-2s, and any 1099-INT, 1099-DIV or 1099-NEC. Paper is fine. You'll take a photo.

Part 1 · Your account

  1. 1

    Open Create your account

    Anyone can make an account. Create an account.

  2. 2

    Make your account

    Enter your email and pick a password of at least 12 characters. A short sentence works well. Press Create account.

  3. 3

    Save your recovery code

    You'll see your recovery code once. Write it down or save it in a password manager. Tick I saved my recovery code, then press Continue.

    There's no “forgot password”. If you lose both your password and this code, your return is gone for good. We can't open it for you. That's what keeps it private.

    Create an account · Sign in

  4. 4

    Confirm your email

    We email you a link. Press it. Until you do, you can look around but not upload, have your AI answer for you, or sign. No email? Press Resend on your Account page.

Part 2 · Your documents

  1. 5

    Start your return

    On the home page, pick the year under Which year? and press Start my return.

  2. 6

    Upload your W-2s

    On Upload, add a photo or PDF of each W-2 and any 1099-INT. On a phone, take the photo right there. We keep only the words from a photo, never the picture. On a computer you can add several files or a whole folder.

Part 3 · Connect your AI (optional)

Rather type it yourself? See No AI in step 8. With an AI, it reads what you uploaded, types in the numbers and asks you the questions in chat. You see it all appear here.

  1. 7

    Make your AI link

    A private link, like a key, that lets your AI reach your return. To make one:

    1. Open Connect your AI (right after sign-up, or on the home page), or your Account page.
    2. For Claude, tap Add to Claude. For ChatGPT or Gemini, open its steps and tap Copy my link.

    You see the link once, so paste it into your AI right away (step 8). Keep it private, like a password. Lost it? Press Remove next to it on the Account page and make a new one. Up to 3 links, one per AI.

  2. 8

    Add the link to your AI

    Tap your AI. Menu names can differ a little. There's no sign-in: the link is the key.

    Gemini

    The Gemini app (gemini.google.com): we haven't confirmed yet that it takes custom links. Worth one try, on a computer:

    1. Open gemini.google.com/customize/connectors and tap Custom. Paste your link into MCP Server URL and tap Next.
    2. Name it Stellana Tax, paste your link, and add it.

    No Custom apps? Type your forms in yourself (see “No AI” below). It takes a few minutes per W-2.

    If you use a terminal

    The Gemini CLI does work. Run this, with your link in place of <your link>:

    gemini mcp add -s user --transport http stellana "<your link>"
    Claudeclaude.ai or the Claude app
    1. Open Settings → Connectors → Add custom connector.
    2. Name it Stellana Tax, paste your link, and add it.
    ChatGPT
    1. Open Settings → Apps → Advanced settings → turn on Developer mode.
    2. Add a custom connector and paste your link.

    Typing in numbers needs a Business or Enterprise plan. On other plans ChatGPT can read your forms, and you type the numbers in yourself.

    No AI: type it yourself
    1. On the Upload page, press Type it in myself under each W-2 or 1099-INT and copy the boxes from the paper.
    2. On the Questions page, answer every question.
    3. Then go to step 10.

Part 4 · Fill in, check, sign

  1. 9

    Tell your AI to start

    Start a new chat. Turn on Stellana Tax in its tools menu. Then say this, with your year:

    “Let's do my 2025 taxes.”

    Until your AI connects, the Connect your AI box on each return page has this sentence ready, with your return's year. Tap How to connect it, then tap the sentence to copy.

    Your AI asks only what it can't find in your documents. Answer in the chat.

  2. 10

    Run the check

    Open Check and press Run the check and open signing. If something is still missing, the page says what.

  3. 11

    Review and confirm

    Open Sign. Look over your answers, documents and figures, type your name, Social Security number and address under Your details, then press Confirm all. Change anything later and it asks you to confirm again.

  4. 12

    Sign

    Then do the three boxes:

    1. Press Confirm declaration.
    2. Under Where your refunds go, choose checking or savings, type your bank numbers and press Check refund details. They are only checked for typos, then thrown away.
    3. Under Sign your return, type your name and press Sign.

    You do this on the site yourself: your AI never sees your signature or bank details.

  5. 13

    Print and mail

    Download the forms (Form 1040 and MA Form 1, plus any others listed). Check your name, Social Security number and address on page 1, sign the paper copies by hand, and mail each one to the address in its own instructions.

For developers

Claude Code. In a terminal, with your link in place of the placeholder:

claude mcp add --transport http stellana "<your link>"

Then tell it (or Gemini CLI) which folder holds your tax documents. It uploads them with a private 15-minute link, not as chat attachments. It still reads the text of what it uploads.

Gemini CLI, by file. Instead of the command above, put this in ~/.gemini/settings.json. Without -s user, the command applies to the current project only.

{
  "mcpServers": {
    "stellana": {
      "httpUrl": "<your link>"
    }
  }
}

Any other AI that takes an MCP connector link works the same way.

How your return is checked

  • Every number has a source. Each line shows the form, box and page it came from, or the rule behind it.
  • A second program checks. OpenTaxSolver redoes every line it covers. Lines it doesn't cover (mostly Massachusetts) rest on cited rules and tests. Any unexplained difference blocks signing.
  • Only you sign. Your bank details, declaration and signature stay on the web page. They never go to the AI.

Your privacy

Everything is encrypted. Your password, your recovery code or one of your AI links unlocks it, and our server unlocks it in memory while you or your AI use it.

  • It's kept apart from every other account.
  • Remove an AI link any time on your Account page and it stops working at once. Using your recovery code removes every AI link too, so you'd make new ones.

Full details: How your data is protected.