Heed MCP Server

by heed Your server? Claim it

answering

Heed is answering right now. Last checked 3 min ago. It exposes 35 tools.

Tax intelligence for lives across borders: residency days, rates, rules and moves, as the member.

Uptime history 12 hours of history

12 hours agonow

100.0%

Uptime 24h

44 of 44 checks

Tools

read from the server

889 ms

Response time

average over 24h

open, no key

Access

streamable-http

Nothing serious here today

Today is the operative word: we check Heed every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 3 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add mcp --transport http https://mcp.heed.finance

Settings → Connectors → Add custom connector, then paste this address

https://mcp.heed.finance

~/.codex/config.toml

[mcp_servers.mcp]
url = "https://mcp.heed.finance"

.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.heed.finance"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.heed.finance"
    }
  }
}

Available tools 35

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

company

add_company

Record a company, holding or structure the signed-in member owns, as on Heed's Companies page: name, country, form (company, holding, trust, foundation, partnership, SPV, branch, other), incorporation date, ownership share, status and purpose. Its country then feeds the member's change feed. This writes to their real record: confirm the details in words first. Returns the company as stored, with its id.

find_company_structures

Company forms Heed has researched, cheapest first by official fees: setup, yearly renewal and the three-year cost, each with the authority's own fee page, plus tax rate and, where Heed has it on file, a local director or office requirement and a residence visa (null means not on file, never no). Filter by country, category (private_limited, onshore_llc, freezone, offshore_ibc, holding_co, foundation_trust) or operating companies only. Use it for 'cheapest company in X' and 'where should I incorporate'.

remove_company

Delete one of the signed-in member's recorded companies (from list_companies). A company that was wound up is better marked dissolved with update_company; use this for one recorded by mistake. It removes the row from their record, so name the company and get a yes first. Returns what was removed.

update_company

Change one of the signed-in member's recorded companies (from list_companies): name, country, form, incorporation date, ownership share, status (active, dormant, dissolved), purpose or notes. Send only what changes. This writes to their real record: confirm the change in words first. Returns the company as stored.

residency

get_residency_risk

Answers 'am I safe', 'am I at risk of becoming resident' and 'will I go over': the countries where the signed-in member is close to, or past, a residency threshold they want to stay under (or short of one they want to reach), with a projected date at their current pace and the rule's official source when Heed has proven it. The declared tax residency is never reported as a risk. The summary field is the one-line answer; an empty at_risk list means nothing is near a line.

get_residency_status

Answers 'how many days do I have left in X', 'how many days have I spent in X' and 'where do I stand': day count, threshold and days remaining for each country the signed-in member has logged days in, under that country's own counting rule (tax year, rolling window, the member's custom threshold), each with the rule's official source when Heed has proven it, plus the stretches of three days or more with no location logged (unlogged_gaps), so you can offer to fill them. The summary field is the one-line answer. Pass a country to narrow it to one. Use get_residency_risk for 'am I safe'.

list_residency_days

The individual days the signed-in member has logged, optionally for one country and date range. Use it to check what is behind a count or before removing days; get_residency_status gives the totals.

remove_residency_days

Delete logged residency days for a country and date range. This permanently removes entries from the member's record, so list them first (list_residency_days) and confirm the country and the exact dates before calling.

position

get_my_position

The signed-in member's Heed profile: declared tax residency, the countries they spend time in, income types, asset classes, citizenships, household (single, married or a partner they are not married to: family and dependant visa routes usually need a legal marriage) and any offshore entity. Read it first when a question depends on who the person is; the planning tools read it themselves. Call list_companies for the companies on record.

run_position_analysis

Run Heed's Position Optimiser for the signed-in member and return its score and ranked findings. It spends no credit; it takes up to a minute, so run it when the member asks for it and do not repeat it in the same conversation.

update_my_position

Change the signed-in member's Heed profile: declared tax residency, citizenships, the countries they spend time in, income types, asset classes, wealth bracket, the situations on their horizon, crypto mode, and the residency goal per country (establish or avoid, with an optional custom threshold). Use it when the member says something like 'I now live in Lisbon', 'I sold my crypto' or 'track Spain for me'. Partial: send only what changes. Values come from Heed's own lists (the tool names them when one does not fit). This changes their real record, so repeat the change in words and get a yes before calling. Returns the whole position after the write.

change

get_change_cost

For one Change Feed item: the rate before and after, and what the change costs or saves per 10,000 (or another amount) of the income it touches, from rows a person at Heed approved. Use it after list_change_feed_items when someone asks 'what does this mean for me' or 'what does this change cost me'. Many changes carry no approved figure yet; the tool says so. The summary field is the one-line answer.

list_change_feed_items

Answers 'what changed' and 'any news on X': recent tax rule changes Heed has published (enacted, in force or proposed), newest first, optionally for one country. Each carries its status, effective date, severity and official source. Use get_change_cost with an item's id for what it costs per 10,000 of the income it touches.

checklist

add_checklist_item

Add a to-do to the signed-in member's Checklist in Heed, with an optional detail and due date. Use it when the member says 'remind me to', 'add to my checklist' or 'I need to file X by'. This writes to their real record: repeat the item and the date in words first. Returns the item with its id.

list_checklist_items

The signed-in member's Checklist in Heed: open items by default (the ones the feed matched to them, their move checklist lines and their own to-dos), each with its id, due date and where it came from. Use it for 'what do I still need to do' and before complete_checklist_item.

account

get_account_access

Which Heed plan the connected account is on and which tools it may use. Call it first when a tool is missing from the list or answers that the plan does not include it. Available to every signed-in account.

affected

find_affected_clients

List which of the signed-in advisor's clients are affected by a specific Change Feed item, with the reasons they match. Read-only; uses the same matching engine as the Change Feed. Advisor accounts.

best

get_best_move_date

Answers 'when is the best day to move' and 'if I leave on this date, am I still resident': how the day the member leaves one country for another plays against both countries' residency day tests, on their logged days: the latest day to leave and stay under the origin's test this tax year, the first year they can be non-resident, and what a given move date would do. Days only; a home, family or work in a country can still make someone resident. The summary field is the one-line answer.

client

get_client_summary

Profile signals, calendar-year residency day counts per country and open tasks for one client of the signed-in advisor. Read-only. Advisor accounts.

companies

list_companies

The companies, holdings and structures the signed-in member has recorded in Heed (the Companies page), with each one's id, form, country, incorporation date, ownership share and status. Call it before update_company or remove_company to find the id, and for 'what companies do I have'.

compare

compare_jurisdictions

Side-by-side headline rates and residency rules for two to five countries Heed tracks, each with its official source. Use it when someone weighs places against each other; use run_scenario to measure a move against their own profile.

complete

complete_checklist_item

Mark an item on the signed-in member's Checklist as done (from list_checklist_items), reopen one, or set its due date. Use it when the member says 'I've done that' or 'move that to the 15th'. A date set here is the member's own and the feed will not move it. This writes to their real record: name the item first. Returns the item as stored.

exit

get_exit_rules

Answers 'what happens if I leave X' and 'is there an exit tax': what a country does when someone leaves it or sells a business from it: exit tax and its threshold, deferral, the temporary non-residence rule, founder relief, participation exemption, whether residence ends by tax year or day count, and whether tax follows citizenship. Reviewed rows only; a country without one is said to have none on file. The summary field is the one-line answer.

jurisdiction

get_jurisdiction_rates

Headline tax rates and residency rules for one country Heed tracks, with the official source and the date each was last checked, plus enacted rate changes that take effect later and the next budget dates. Use it for 'what is the tax in X'. For a region inside a federal country (US states, Swiss cantons, Spanish communities) follow with get_region_rates.

jurisdictions

list_jurisdictions

Every country Heed tracks, with its two-letter code, whether a public guide exists and whether it has regional rates. Call it once when you need to know which names the other tools accept, or to check coverage before asking about a country.

log

log_residency_days

Add days spent in a country to the signed-in member's residency tracker. Writes to their real record, so confirm the country and the exact dates with them first and never infer dates. Days already logged are kept (their kind and note are updated when given).

move

get_move_checklist

The steps of a move from one country to another, before, during and after, with the documents to carry and a suggested provider where Heed works with one (company formation and bookkeeping in Singapore, Hong Kong, the UK and the UAE). Built from the member's profile and reviewed exit rules only. Give a move date to get a due date per step.

notification

update_notification_preferences

Change the signed-in member's alert settings, as on Heed's Settings page: urgent alerts by email, monitor alerts by email, the weekly digest, how often alerts arrive (realtime, daily, weekly) and countries to mute. Send only what changes. Use it for 'stop emailing me about X' or 'send me a weekly digest instead'. Confirm first. Returns every setting as stored.

propose

propose_action

Create a PROPOSED action (task, draft, document request, channel alert) for advisor approval in the Heed dashboard. Nothing is sent, changed or posted by this tool: it only queues the request. Advisor accounts.

proposed

list_proposed_actions

List the firm's proposed actions (pending approvals by default). Every consequential Heed action passes this queue; approval and execution happen in the Heed dashboard, never through MCP. Advisor accounts.

region

get_region_rates

Rates for the regions of a country where tax differs by state, canton, province or community: AU, BE, CA, CH, ES, IN, MY, US. A proven row holds the combined rate a resident pays, national tax included; an unproven row is the regional layer only. Pass a region to narrow it to one.

save

save_scenario

Save a move comparison to the signed-in member's Scenario Planner, so it appears under their saved scenarios in Heed: the origin (their declared tax residency unless given), the destination, the planned move date and a label. Use it after run_scenario when the member says 'save that'. Pro. Saves nothing else; it writes one row to their record, so confirm first. Returns the saved scenario with its id.

scenario

run_scenario

Answers 'what if I move to X' and 'what would I pay in X': the signed-in member's current country against a target one across the income and asset types on their profile, with the headline rate delta for each. Saves nothing. The summary field is the one-line answer. Follow with get_best_move_date, get_exit_rules and get_move_checklist for the timing, the exit charge and the steps.

stability

get_stability_ranking

How often each country with a Heed guide has changed its tax rules: changes recorded in the last 12 and 24 months, a band from stable to volatile, and the ranking from steadiest to busiest. Pass a country for its own band and position. 'How often does this place move the goalposts' is a planning question, so use it beside rates.

visa

find_visa_routes

Visa and residence programmes Heed has researched: who they are for, income or investment thresholds, processing time, validity, whether they allow remote work and dependants, whether they trigger tax residency and the path to permanent residence, each with the authority's own page. Filter by country, category (work, student, family, investor, talent, digital_nomad, retirement, startup, tax_regime, golden_visa, passive_income, other), remote work or a path to permanent residence. Use it for 'which visa', 'can I live in X' and 'how do I get residence in X', and with get_move_checklist for a move.

Endpoints

URL	Transport	State	Latency	Checked
https://mcp.heed.finance	streamable-http	answering	1839 ms	3 min ago

Alternatives to Heed

same job, measured the same way

Helious market intelligence

by helious

US Treasury auction tails, the live curve regime, scored macro releases, and why rates moved.

27 tools answering

Package Intel MCP

by datakoot

Package intelligence for AI agents across npm, PyPI, crates.io and deps.dev. No API keys.

6 tools answering

DC Blueprint data-centre intelligence

by dcblueprint

Dated European data-centre markets, grid connection restrictions, country rules and the live grid.

6 tools answering

Syslog MCP

by tootie

Syslog receiver and MCP server for homelab log intelligence.

answering

rag-rat

by cq27-dev

Repository intelligence, code graph, history, papertrail, and cross-agent memory for coding agents.

110 installs/wk local only

Mtg Oracle

by gregario

Magic: The Gathering MCP server — cards, rules, combos, and Commander intelligence

65 installs/wk local only

Celmis

by constantinemakoid

Self-hosted code intelligence: cross-repo Q&A, dependency audits and PR review, over MCP

local only

Compete Competitive Intelligence

by niyonzimabryan

Typed access to monitored competitive changes, evidence, dossiers, research, and collection health.

57 installs/wk local only

Heed — questions

Answers built from our own checks of this server.

What can Heed do?

It exposes 35 tools, read directly from the server on our last check. Among them: add_checklist_item, add_company, compare_jurisdictions, complete_checklist_item, find_affected_clients, find_company_structures and 29 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Heed mostly used for?

Its tools cluster around residency, company and position. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Heed working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 44 of 44 checks got a reply (100.0%), average response time 889 ms. The bar chart above shows every period we have measured.

How do I connect Heed?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Heed need an API key?

No. Heed completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 35 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Heed?

It answers our handshake in 889 ms on average, which is faster than 8% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.