Developers

The research data, on demand.

A REST API and an MCP server expose the same four tools Advium’s own assistant uses to answer fee questions. Every response carries the source document, the date it was checked and any component that is missing, so your application can show its working.

Get a key REST reference MCP server

100 free calls a month with your account, then one credit per call. Keys are created on your account page.

What you get

Four tools, one dataset.

The same names on REST and MCP. Percentages are decimal fractions (0.0019 means 0.19% a year); dollar amounts are a year. A total cost is null whenever a fee component is missing; the known-cost subtotal always says what it includes.

research_super_platforms

Funds, platform products and the investment options on each menu.

2,445 super investment options across 58 funds and 44 platform products, from issuer disclosure documents and regulator statistics.

calculate_super_total_cost

Platform plus option costs at a stated balance, with every component and anything missing named.

Tiered administration fee tables priced at the balance, the option's investment, transaction and performance fees, and any fixed dollar fee.

compare_super_platforms

Platform fees across funds at one balance, complete records ranked first.

Every platform product with a complete fee record ranked by known cost; incomplete records listed after, unranked, with their missing components.

search_investment_products

ETFs, listed investment companies, managed funds and direct equities with their management fee and source.

3,664 investment products with the management fee, asset type, issuer, source document and date checked.

Authentication

One key, sent as a bearer token.

Create up to 5 keys on your account page. A key starts with rsk_, is shown once when created, and can be revoked at any time. Revoking a key stops every client that used it.

Each REST request and each MCP tool call uses one unit of your allowance: 100 free calls a month, then one credit per call from the packs on the pricing page. When the allowance is used and no credits remain, the call returns 402 and does not reach the data.

Authorization: Bearer rsk_...

HTTP/1.1 402 Payment Required
{
  "error": "Free monthly allowance used. Buy credits at research.advium.ai/account.",
  "usage": { "compares_month": 4, "api_calls_month": 100, "paid_balance": 0 },
  "limits": { "api_calls_per_month": 100, "api_keys": 5 }
}

REST

One POST per tool.

Send the tool’s input as a JSON object and get its result back as JSON. The tool list carries each tool’s input schema.

List the tools

GET https://api.advium.ai/api/research/v1/tools

Returns each tool’s name, description and JSON input schema.

Run a tool

POST https://api.advium.ai/api/research/v1/tools/{name}

Body is the tool input. Unknown tool names return 404; invalid input returns 400 with the reason.

research_super_platforms

Funds, platform products and the investment options on each menu.

No arguments lists the funds. Pass fund to list its products; pass fund and product to list that product's options with fees.

curl -X POST https://api.advium.ai/api/research/v1/tools/research_super_platforms \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{}'

calculate_super_total_cost

Platform plus option costs at a stated balance, with every component and anything missing named.

fund, product and balance (dollars) are required; option_name is optional (omit it for platform fees only).

curl -X POST https://api.advium.ai/api/research/v1/tools/calculate_super_total_cost \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{"fund":"AustralianSuper","product":"AustralianSuper (Accumulation)","balance":250000,"option_name":"Balanced"}'

compare_super_platforms

Platform fees across funds at one balance, complete records ranked first.

balance (dollars) is required; funds is an optional list of fund names to restrict the comparison.

curl -X POST https://api.advium.ai/api/research/v1/tools/compare_super_platforms \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{"balance":250000}'

search_investment_products

ETFs, listed investment companies, managed funds and direct equities with their management fee and source.

q (a name, ticker or code) is required; limit is optional, up to 50.

curl -X POST https://api.advium.ai/api/research/v1/tools/search_investment_products \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{"q":"VAS"}'

Response shape

A calculate_super_total_cost response with a missing performance fee. The total is null; the known-cost subtotal and the missing component are named so nothing is invented.

{
  "fund": "AustralianSuper",
  "product": "AustralianSuper (Accumulation)",
  "balance_dollars": 250000,
  "fee": {
    "platform_fee": { "admin_fixed_dollars": 52.00, "admin_variable_dollars": 250.00, "platform_fee_dollars": 302.00 },
    "option_fee": { "mer_icr_percent": 0.0052, "option_fee_dollars": 1300.00, "components": { "investment": "present", "transaction": "present", "performance": "missing" } },
    "components_missing": ["performance"],
    "known_cost_dollars": 1602.00,
    "total_ongoing_dollars": null,
    "complete": false
  },
  "source_url": "https://www.australiansuper.com/...",
  "fee_date_checked": "2026-08-14"
}

MCP server

Ask about fees in plain language.

Add the server as a connector in your AI client and the model can look up funds, price a balance and compare platforms itself, quoting the source and date on every figure.

Server URL

https://api.advium.ai/api/research/mcp

Streamable HTTP, stateless: every request is a single JSON-RPC POST, no session and no event stream. Authorise with your key as a bearer token, or through the sign-in page your client opens (OAuth 2.1 with PKCE; the token it returns is your key).

Claude (claude.ai)

Settings, then Connectors, then Add custom connector.
Paste https://api.advium.ai/api/research/mcp as the server URL.
A sign-in page from api.advium.ai opens. Paste your rsk_ key there; the connector keeps it.
Start a chat and ask about a fund, a balance or a product. The tools appear under the connector's name.

Claude Code

Run the command below once. Claude Code stores the header with the server entry.

claude mcp add --transport http advium-research https://api.advium.ai/api/research/mcp \
  --header "Authorization: Bearer rsk_..."

ChatGPT

Settings, then Connectors, then Add (developer mode where your plan requires it).
Enter https://api.advium.ai/api/research/mcp. ChatGPT walks the OAuth flow; paste your key on the page that opens.

Gemini, Grok and other clients

Where the client supports remote MCP servers, add the server URL and set an Authorization header of Bearer followed by your key.
Clients that only support OAuth use the same sign-in page as Claude; clients that only support headers use the key directly.

Initialize

curl -X POST https://api.advium.ai/api/research/mcp \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

List tools

curl -X POST https://api.advium.ai/api/research/mcp \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

tools/call takes the same names and inputs as the REST reference. Notifications are acknowledged with an empty 202. There are no prompts or resources on this server.

Knowledge

Tax, super and Age Pension rates, with a source on every figure.

A second server on the same key: the verified rate sets Advium’s own calculators run on, by financial year, each figure carrying its citation, the page URL where one is known and the date it was checked; the documented methodology of every calculator; and 20calculators you can run with the platform’s own engine. Unknown years are refused rather than guessed. Modelling defaults, which have no published source, are never served. Nothing here is advice.

MCP server

https://api.advium.ai/api/knowledge/mcp

Same transport and sign-in flow as the research server. Add it as a second connector, or use the Claude Code command below.

REST

GET https://api.advium.ai/api/knowledge/v1/toolsPOST https://api.advium.ai/api/knowledge/v1/tools/{name}

One credit per call from the same allowance as the research tools.

claude mcp add --transport http advium-knowledge https://api.advium.ai/api/knowledge/mcp \
  --header "Authorization: Bearer rsk_..."

list_rate_years

The financial years a verified rate set exists for, and which one is current.

No arguments.

curl -X POST https://api.advium.ai/api/knowledge/v1/tools/list_rate_years \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{}'

get_rates

Every verified rate and threshold for a financial year, one domain or all, with the source entry for each figure returned.

fy is optional (current year when omitted; an unknown year is refused). domain is optional: tax, super, agePension, pensionDrawdown, fhss, downsizer, frcgw, etp, stampDuty, landTax, serviceability or investmentReform. include_indicative shows placeholder domains (LMI premiums, aged care) too.

curl -X POST https://api.advium.ai/api/knowledge/v1/tools/get_rates \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{"fy":"2026-27","domain":"super"}'

explain_figure

One figure with its value, unit, status, citation, URL where known, the date it was checked and its effective date.

path is required (dotted, such as super.concessionalCap or tax.sapto.single.shadeOutThreshold); fy is optional.

curl -X POST https://api.advium.ai/api/knowledge/v1/tools/explain_figure \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{"fy":"2026-27","path":"super.concessionalCap"}'

list_calculators

The calculator library: slug, name, category, purpose and whether it can be run.

category (Tax, Retirement, Investing, Lending, Super, Insurance) and region (AU or US) are optional filters.

curl -X POST https://api.advium.ai/api/knowledge/v1/tools/list_calculators \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{"category":"Tax"}'

get_calculator_methodology

How one calculator works: purpose, method, every input with its default and range, every output, a sample input.

slug is required, from list_calculators.

curl -X POST https://api.advium.ai/api/knowledge/v1/tools/get_calculator_methodology \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{"slug":"income-tax-estimate"}'

run_calculator

Run a calculator with the verified rate set for a year and get its result with the compliance block.

slug and inputs are required (inputs follow the calculator's own schema); fy is optional. Only calculators marked runnable can be run.

curl -X POST https://api.advium.ai/api/knowledge/v1/tools/run_calculator \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{"slug":"income-tax-estimate","inputs":{"grossIncome":100000,"residency":"resident"}}'

explain_figure response

The 2026-27 concessional contributions cap: the value, its unit, the citation, the ATO page, the date it was checked and the date it took effect. A path without a source on file returns 404 rather than a bare number.

{
  "financialYear": "2026-27",
  "path": "super.concessionalCap",
  "value": 32500,
  "unit": "aud",
  "status": "verified",
  "citation": "ATO, Key superannuation rates and thresholds, concessional contributions cap 2026-27",
  "url": "https://www.ato.gov.au/tax-rates-and-codes/key-superannuation-rates-and-thresholds",
  "verified_on": "13/07/2026",
  "effective_from": "01/07/2026",
  "jurisdiction": "AU",
  "notice": "Not advice. Verify against the cited source before relying on it."
}

get_rates response

One domain for one year. Each domain reports its status: verified, indicative (a placeholder, returned only when asked for) or absent. The sources list covers every figure in the values.

{
  "financialYear": "2026-27",
  "ratesCurrentAsAt": "13/07/2026",
  "domains": {
    "super": {
      "status": "verified",
      "values": { "concessionalCap": 32500, "nonConcessionalCap": 130000, "generalTransferBalanceCap": 2100000, ... },
      "sources": [ { "path": "super.concessionalCap", "citation": "ATO, ...", "verifiedOn": "13/07/2026", ... }, ... ]
    }
  },
  "notice": "Not advice. Verify against the cited source before relying on it."
}

run_calculator

Inputs follow the calculator’s own schema; get_calculator_methodology lists every field with its default and range. Invalid inputs come back as 400 with the field and the reason. The result carries the rate set it used and the compliance block Advium prints on its own documents.

Runnable today: income-tax-estimate, super-contributions, super-contribution-opportunity, division-293, age-pension-means-test, stamp-duty, land-tax, cgt-property-sale, super-fund-comparison, fhss-maximiser, downsizer-contribution, redundancy-etp-planner, account-based-pension, transition-to-retirement, borrowing-capacity, home-loan-amortisation, cashflow-surplus, debt-recycling, non-resident-cgt, retirement-modelling.

curl -X POST https://api.advium.ai/api/knowledge/v1/tools/run_calculator \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{"slug":"income-tax-estimate","fy":"2026-27","inputs":{"grossIncome":100000,"residency":"resident","hasPrivateHospitalCover":false}}'

{
  "slug": "income-tax-estimate",
  "resultType": "IncomeTaxResult",
  "financialYear": "2026-27",
  "ratesCurrentAsAt": "13/07/2026",
  "unverified": false,
  "result": { "taxableIncome": 100000, "incomeTax": ..., "medicareLevy": ..., "netIncome": ... },
  "compliance": { "generalAdviceWarning": "...", "disclaimer": "...", "financialYear": "2026-27" },
  "notice": "Not advice. Verify against the cited source before relying on it."
}

The sources promise

Every figure the Knowledge server returns cites its source and the date it was checked, and the rate set is re-checked against the ATO and Services Australia pages by an automated job whose report is published in the methodology. A financial year we do not hold is refused, not approximated. Modelling defaults are not served because they have no published source. Percentages marked fraction are decimal fractions (0.15 means 15.00%); percent means percentage points as published. None of it is advice, a rating or a recommendation.

Rate limit

60 a minute

Requests per key on the developer surface. Beyond that the call returns 429; wait and retry.

Allowance

100 free a month

Then one credit per call, shared across the research and knowledge servers. Usage and credits are on your account page.

Fair use

The data is factual information, not advice, a rating or a recommendation; say so where you show it. Do not redistribute the dataset as a whole. Keep the source and date with any figure you display.

Keys

Create and revoke keys on your account page. If keys are not open on your account yet, the page says so and the free comparison tool uses the same data in the meantime.

Go to your account See pricing