Global Debt & Fiscal Explorer

Freshness

Last updated: 2026-06-24.

If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples.

What This Tool Does

Explore the financial health of any country in the world. Look up national debt levels, government spending, tax revenue, and fiscal balances — all expressed as easy-to-understand ratios and percentages of GDP. Compare countries, track trends over time, and assess debt sustainability at a glance.

Product Instructions

Global Debt & Fiscal Explorer

Query national debt levels, government spending, tax revenue, fiscal balances, and debt sustainability indicators for any country from the World Bank World Development Indicators database.

Actions

query_fiscal_data

Fetch fiscal and debt data for a country or region with optional debt sustainability assessment.

Optional fields (all have defaults):

• country_or_region (string) — Country name or region in plain English (e.g., "United States", "Greece", "Kenya", "World"). Defaults to "World" if not provided. Supports plain English names or ISO3 codes.
• fiscal_aspect (string) — Which category of fiscal data to query. Default: "all".
  • "debt" — External debt stocks, external debt/GNI ratio, central government debt/GDP, short-term and long-term debt, debt service/exports ratio
  • "balance" — Cash surplus/deficit (% of GDP), primary balance (% of GDP)
  • "revenue" — Tax revenue (% of GDP), government revenue excluding grants (% of GDP)
  • "expenditure" — Government expense (% of GDP), education/health/military expenditure (% of GDP)
  • "debt_service" — Total debt service, debt service/exports ratio, interest payments (% of revenue), multilateral and bilateral debt
  • "all" — All fiscal indicators combined
• calculate_debt_ratios (boolean) — Calculate debt sustainability ratios and compare against IMF/World Bank Debt Sustainability Framework thresholds. Default: true.
• time_period (string) — Default: "latest".
  • "latest" — Most recent 10 data points (returns the most recent non-null value)
  • "YYYY" — Specific year (e.g., "2020")
  • "YYYY:YYYY" — Year range (e.g., "2015:2020")

Example — All fiscal data for a country:

{
  "country_or_region": "Kenya",
  "fiscal_aspect": "all",
  "time_period": "latest"
}

Example — Debt sustainability analysis:

{
  "country_or_region": "Greece",
  "fiscal_aspect": "debt",
  "calculate_debt_ratios": true,
  "time_period": "latest"
}

Example — Government revenue over time:

{
  "country_or_region": "United States",
  "fiscal_aspect": "revenue",
  "time_period": "2015:2023"
}

Example — Expenditure breakdown:

{
  "country_or_region": "Nigeria",
  "fiscal_aspect": "expenditure",
  "time_period": "latest"
}

Example — Fiscal balance for a specific year:

{
  "country_or_region": "Brazil",
  "fiscal_aspect": "balance",
  "time_period": "2022"
}

Example — Debt service analysis:

{
  "country_or_region": "Sri Lanka",
  "fiscal_aspect": "debt_service",
  "calculate_debt_ratios": true,
  "time_period": "2018:2023"
}

Response Format

Responses include:

• data — Per-indicator results with value, date, country name, indicator description, and unit. For time-range queries, includes a time_series array of date/value pairs.
• debt_sustainability_assessment — When calculate_debt_ratios is true and debt data is available:
  • overall_risk_level — low, moderate, high, or critical
  • sustainability_indicators — Individual ratio assessments against IMF/World Bank thresholds
  • risk_factors — List of identified debt risks
• fiscal_balance_assessment — Fiscal position analysis:
  • fiscal_position — surplus or deficit
  • sustainability_level — strong, sustainable, warning, or critical
  • Maastricht criterion comparison (-3% GDP threshold)
• fiscal_space_analysis — Revenue vs. expenditure analysis:
  • Revenue and expense as % of GDP
  • Interest burden assessment
  • Revenue mobilization assessment (weak/moderate/strong/very strong)
• expenditure_allocation — Education, health, and military spending as % of GDP
• sdg_alignment — SDG 8, 16, and 17 alignment information
• summary — Data availability statistics

Fiscal Indicators by Aspect

| Aspect | Indicators | |---|---| | debt | External debt stocks (US$), External debt/GNI %, Central govt debt/GDP %, Short-term debt, Long-term debt, Debt service/exports % | | balance | Cash surplus/deficit (% GDP), Primary balance (% GDP) | | revenue | Tax revenue (% GDP), Government revenue excl. grants (% GDP) | | expenditure | Government expense (% GDP), Education spending (% GDP), Health spending (% GDP), Military spending (% GDP) | | debt_service | Total debt service (US$), Debt service/exports %, Interest payments (% revenue), Multilateral debt, Bilateral debt |

Debt Sustainability Thresholds (IMF/World Bank DSF)

| Indicator | Low Risk | Moderate Risk | High Risk | |---|---|---|---| | External debt/GNI | < 30% | 30-40% | > 55% | | Debt service/exports | < 15% | 15-20% | > 25% | | Government debt/GDP | < 50% | 50-70% | > 90% |

Important Notes

• Data is sourced from the World Bank World Development Indicators database.
• Country names are resolved against a built-in mapping; use common English names or ISO3 codes.
• Data availability varies significantly by country; developing countries may have more gaps.
• Most recent data may be 1-3 years behind the current year.
• Percentage indicators with suspiciously small values are automatically corrected for a known World Bank API scaling bug.
• Years must be between 1960 and the current year.

When To Use

• Use this skill for Global Debt & Fiscal Explorer on AgentPMT.
• Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape.
• Search and activation keywords: global debt & fiscal explorer, debt fiscal management, research a country's national debt level, compare government debt across countries, analyze tax revenue trends over time, check fiscal balance and budget deficits, query fiscal data, country or region.
• Supported action names: query_fiscal_data.

Use Cases

• Research a country's national debt level
• Compare government debt across countries
• Analyze tax revenue trends over time
• Check fiscal balance and budget deficits
• Evaluate debt sustainability ratios
• Study public expenditure patterns
• Track debt service costs
• Support academic research on fiscal policy
• Assess sovereign credit risk indicators
• Monitor government revenue as a percentage of GDP

Categories And Industries

No categories or industry tags are published for this tool.

Actions And Schema

Complete generated action schema: ./schema.md. Supported action count: 1. x402 availability: not enabled for this product.

• query_fiscal_data (action slug: query-fiscal-data): Query national debt, government revenue, public expenditure, fiscal balance, and debt service data for any country or region from the World Bank. Price: 30 credits. Parameters: calculate_debt_ratios, country_or_region, fiscal_aspect, time_period.

Live Schema And Examples

Use the compact schema above for ordinary calls. Before a new production integration, or whenever parameters, enum values, nested objects, outputs, or examples are unclear, fetch live details first.

• Exact schema: call agentpmt-tool-search-and-execution with action: "get_schema", and tool_id: "debt-fiscal-management".
• Detailed examples: call agentpmt-tool-search-and-execution with action: "get_instructions" and tool_id: "debt-fiscal-management", or call this product with action: "get_instructions" when the product tool is already selected.
• Treat returned live schema and instructions as more specific than this generated summary.

MCP schema lookup through the main AgentPMT MCP server:

{
  "method": "tools/call",
  "params": {
    "name": "AgentPMT-Tool-Search-and-Execution",
    "arguments": {
      "action": "get_schema",
      "tool_id": "debt-fiscal-management"
    }
  }
}

For live examples, keep the same MCP tool and use these arguments:

{
  "action": "get_instructions",
  "tool_id": "debt-fiscal-management"
}

Authenticated AgentPMT REST schema lookup body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_schema",
    "tool_id": "debt-fiscal-management"
  }
}

Authenticated AgentPMT REST live examples body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_instructions",
    "tool_id": "debt-fiscal-management"
  }
}

Call This Tool

Product slug: debt-fiscal-management

Marketplace page: https://www.agentpmt.com/marketplace/debt-fiscal-management

• AgentPMT account route: first use ../agentpmt-account-mcp-rest-api-setup to connect the main MCP server or REST API for an Agent Group where this tool is enabled.
• x402 route: not enabled for this product.
• AgentPMT overview: use ../what-is-agentpmt for marketplace, Agent Group, workflow, MCP, REST, and payment concepts.

If those setup skills are not installed beside this product skill, use the downloads below.

Core AgentPMT setup skills:

• What AgentPMT is: ../what-is-agentpmt
  • ClawHub page: https://clawhub.ai/agentpmt/what-is-agentpmt
  • OpenClaw install: openclaw skills install what-is-agentpmt
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup
  • ClawHub page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup
  • OpenClaw install: openclaw skills install agentpmt-account-mcp-rest-api-setup
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

skills.sh install script:

npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

MCP call shape after the main AgentPMT MCP server is connected:

{
  "method": "tools/call",
  "params": {
    "name": "Global-Debt--Fiscal-Explorer",
    "arguments": {
      "action": "query_fiscal_data",
      "calculate_debt_ratios": true,
      "country_or_region": "example country or region",
      "fiscal_aspect": "all",
      "time_period": "latest"
    }
  }
}

Use the exact tool name returned by tools/list; the name above is the expected readable form.

Authenticated AgentPMT REST call body:

{
  "name": "debt-fiscal-management",
  "parameters": {
    "action": "query_fiscal_data",
    "calculate_debt_ratios": true,
    "country_or_region": "example country or region",
    "fiscal_aspect": "all",
    "time_period": "latest"
  }
}

Use the setup skill for the account connection details before making REST calls.

Response Handling

• Treat the returned JSON as the source of truth for this tool call.
• If the response includes warnings or correction targets, apply them before retrying.
• If the response includes a passed or success-style boolean, use it as the workflow gate.
• If validation fails or the response shape is unclear, call get_schema or get_instructions before retrying.
• If query_fiscal_data fails, preserve the request parameters and retry only after fixing schema, auth, or payment errors.

Security

• Do not place account secrets, wallet private keys, mnemonics, signatures, or payment headers in prompts or logs.
• Keep tool inputs scoped to the minimum content needed for the task.
• Use the setup skills for credential handling; this product skill only defines product-specific behavior.

AgentPMT Reference

• What AgentPMT is: ../what-is-agentpmt (ClawHub: what-is-agentpmt, page: https://clawhub.ai/agentpmt/what-is-agentpmt; skills.sh: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt)
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup (ClawHub: agentpmt-account-mcp-rest-api-setup, page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup; skills.sh: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup)
• Marketplace product: https://www.agentpmt.com/marketplace/debt-fiscal-management
• AgentPMT main MCP server: https://api.agentpmt.com/mcp/
• AgentPMT REST invoke endpoint: https://api.agentpmt.com/products/purchase