Tutorial: Income Tax Rates

Finance

Data source: Curated dataset (government tax authorities, 2024 rates)

Overview

Income Tax Rates performs computations on your inputs — no external data source required. This tutorial covers all 4 tools with parameter reference and code examples.

Prerequisites

Sign up at https://context.gnist.ai/signup for a free API key (100 calls/day).
Choose your integration method: MCP protocol or REST API.

Connect via MCP

Add to your MCP client config (Claude Desktop, Cursor, etc.):

MCP Config

{
  "mcpServers": {
    "gnist-income-tax": {
      "url": "https://context.gnist.ai/mcp/income-tax/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Tools (4)

`get_tax_info`

Get income tax brackets and rates for a country. Returns tax brackets, standard deduction, currency, tax year, and notes about the tax system.

Parameter	Type	Required	Description
`country_code`	string	required	ISO 3166-1 alpha-2 country code (e.g. US, GB, DE, NO).

curl -X POST "https://context.gnist.ai/mcp/income-tax/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_tax_info", "arguments": {"country_code": "US"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/income-tax/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'country_code': 'US'}, 'name': 'get_tax_info'}},
)
print(resp.json())

`calculate_income_tax`

Calculate progressive income tax for a given country and annual income. Returns total tax, effective rate, marginal rate, and a per-bracket breakdown showing how much income falls in each bracket and how much tax is owed per bracket.

Parameter	Type	Required	Description
`country_code`	string	required	ISO 3166-1 alpha-2 country code (e.g. US, GB, DE, NO).
`income`	number	required	Gross annual income in the country's local currency.

curl -X POST "https://context.gnist.ai/mcp/income-tax/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "calculate_income_tax", "arguments": {"country_code": "US", "income": 1.0}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/income-tax/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'country_code': 'US', 'income': 1.0},
            'name': 'calculate_income_tax'}},
)
print(resp.json())

`list_tax_countries`

List all countries with available income tax bracket data. Returns country codes, names, and currencies for all supported countries.

curl -X POST "https://context.gnist.ai/mcp/income-tax/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "list_tax_countries", "arguments": {}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/income-tax/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {}, 'name': 'list_tax_countries'}},
)
print(resp.json())

`report_feedback`

Report a bug, feature request, or general feedback for this data source. Use this when something doesn't work as expected, when you'd like a new feature, or when you have suggestions for improvement. Args: feedback: Describe the issue or suggestion. feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	string	required
`feedback_type`	string	optional	(default: `general`)

curl -X POST "https://context.gnist.ai/mcp/income-tax/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "report_feedback", "arguments": {"feedback": "example"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/income-tax/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'feedback': 'example'}, 'name': 'report_feedback'}},
)
print(resp.json())

Common Patterns

Search then retrieve
Use list_tax_countries to find items, then get_tax_info to get full details. This two-step pattern is common for exploring data before drilling down.

FAQ

What data does Income Tax Rates provide?

Income tax rates and calculator — progressive brackets for 15 countries, with tax computation. It exposes 4 tools: get_tax_info, calculate_income_tax, list_tax_countries, report_feedback.

Does this toolkit require external data?

No. It performs computations on your inputs directly. You only need a Gnist API key.

What format does the Income Tax Rates API return?

JSON, via either MCP protocol (JSON-RPC 2.0) or REST API.