AI assistant access · Pro, Circle and Advisor
Your Heed account, in the AI assistant you already use.
Connect your Heed account to Claude, ChatGPT, Cursor or VS Code. Your assistant reads your position, your residency days and the rules Heed monitors, with their official sources, keeps your profile and companies current when you tell it to, and acts strictly as you.
heed · get_residency_status
Portugal: 155 of 183 days this tax year, 28 to go.
At your current pace you reach the line in mid November.
How it connects
Connect once.
Heed speaks the Model Context Protocol, the open standard assistants use to reach outside tools. The tools stay in your assistant until you disconnect.
01Add the address
In your assistant's connectors or MCP settings, add Heed as a server:
https://mcp.heed.financeAny assistant that takes an MCP server works. The usual ones:
- ClaudeCustomize, Connectors, Add custom connector, then paste the address.Open Claude
- ChatGPTPlugins, the plus button, Add custom MCP server, then paste the address. Not every ChatGPT plan allows custom servers.Open ChatGPT
- CursorOpens Cursor with Heed filled in.Add to Cursor
- VS CodeOpens VS Code with Heed filled in.Add to VS Code
- Claude Code
claude mcp add --transport http heed https://mcp.heed.finance - Codex
codex mcp add heed --url https://mcp.heed.finance
02Approve once
Your assistant would like to connect to your Heed account
On Heed's own sign-in page, signed in as you
- ReadsYour profile, position and residency days, as your account sees them
- Asks firstBefore it logs or removes days, or spends an Optimiser run
- On recordEvery call, under Recent assistant activity in your Settings
03Ask
Using Heed, what is my residency status?
heed · get_residency_status
Portugal: 155 of 183 days this tax year, 28 to go.
At your current pace you reach the line in mid November.
What your assistant can do
Your own numbers, with their sources.
call get_residency_status
- country
- Portugal
- days this tax year
- 155 of 183
- days to the line
- 28
- at this pace
- mid November
Logging or removing days asks you first.
Also in this group
- get_residency_risk
- list_residency_days
- log_residency_days
- remove_residency_days
Questions
What people ask.
Straight answers. Heed is intelligence, not advice.
Any assistant that can add an MCP server with a sign-in, such as ChatGPT, Claude and Cursor. You add Heed's address as a server, sign in with your Heed account, and its tools appear in the assistant's tool list.
Pro, Circle and Advisor. The four tools that work on a firm's clients and its approval queue are for Advisor accounts. Another account can complete the sign-in, but its assistant then sees one tool, which says that the integration needs Pro or above.
No. It acts strictly as you, so it reads only what your own Heed account can read. An advisor's assistant sees the firm's clients only as that advisor does in the app.
Yes, when you tell it to. It can log or remove residency days, update your profile (where you are tax resident, the countries you spend time in, your income and assets, the goal per country), record or change your companies, add to your checklist and tick items off, save a move as a scenario and change your alert settings. Heed's tools tell it to repeat the change in words and get your yes first, and every write reads the record back so the assistant reports what Heed now holds. Nothing is deleted except a company you ask it to remove. For firms it can propose actions, which wait for approval in the dashboard; nothing is sent or posted by the assistant itself.
What the dashboard holds: your residency counts and risk, headline and regional rates with their official sources, exit rules, company forms by official fee, visa routes, the changes Heed has published and what each costs per 10,000, the best day to move and the move checklist. Rate and rule answers carry their official source and the date Heed last checked it.
Ask Heed is Heed's own assistant, writing sourced briefs in the dashboard. AI assistant access brings the same data and sources into the assistant you already use, so it can answer from your own position.
No. Heed is information, not advice, and that holds in your assistant too: it gives you the current rule, its source and your numbers, and what to ask a qualified adviser.