Agents Index

Heed

OnlineNew

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

Visit publisherConnectJSON

What it can do: 36 tools

  • get_account_access read-onlyWhich 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.
  • list_jurisdictions read-onlyEvery 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 ask
  • get_residency_status read-onlyAnswers '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'
  • get_residency_risk read-onlyAnswers '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 re
  • list_residency_days read-onlyThe 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.
  • log_residency_daysAdd 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
  • remove_residency_daysDelete 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.
  • get_my_position read-onlyThe 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 depend
  • get_jurisdiction_rates read-onlyHeadline 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 'wha
  • get_region_rates read-onlyRates 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 i
  • compare_jurisdictions read-onlySide-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
  • get_stability_ranking read-onlyHow 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 ban
  • list_change_feed_items read-onlyAnswers '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 offi
  • get_change_cost read-onlyFor 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 wh
  • run_scenario read-onlyAnswers '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 noth
  • get_best_move_date read-onlyAnswers '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: th
  • get_move_checklist read-onlyThe 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
  • get_exit_rules read-onlyAnswers '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 reli
  • find_company_structures read-onlyCompany 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
  • find_visa_routes read-onlyVisa 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 p
  • run_position_analysisRun 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 conver
  • update_my_positionChange 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 resid
  • list_companies read-onlyThe 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 r
  • add_companyRecord 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 sha
  • update_companyChange 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
  • remove_companyDelete 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 the
  • save_scenarioSave 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 l
  • list_checklist_items read-onlyThe 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
  • add_checklist_itemAdd 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:
  • complete_checklist_itemMark 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 membe
  • update_notification_preferencesChange 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
  • list_proposed_actions read-onlyList 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.
  • propose_actionCreate 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.
  • add_clientsAdd one or more clients (up to 100) to the signed-in advisor's firm, as the Clients page import does: name (required), email, countries, income types, asset classes, notes and tags. Countries and labels are put on Heed's
  • find_affected_clients read-onlyList 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.
  • get_client_summary read-onlyProfile signals, calendar-year residency day counts per country and open tasks for one client of the signed-in advisor. Read-only. Advisor accounts.

Connect it

Claude Code
claude mcp add --transport http heed https://mcp.heed.finance
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://mcp.heed.finance
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "heed": {
      "url": "https://mcp.heed.finance"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "heed": {
      "type": "http",
      "url": "https://mcp.heed.finance"
    }
  }
}

Questions

What does Heed do?

Tax intelligence for lives across borders: residency days, rates, rules and moves, as the member. It exposes 36 tools to AI assistants.

What tools does Heed provide?

36 tools, including get_account_access, list_jurisdictions, get_residency_status, get_residency_risk, list_residency_days, log_residency_days, remove_residency_days, get_my_position, get_jurisdiction_rates, get_region_rates, compare_jurisdictions, get_stability_ranking….

How do I connect Heed to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://mcp.heed.finance as a custom connector or MCP server. Copy-paste setup is on this page.

Does Heed require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Heed online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes Heed?

heed.finance. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Finance & Payments