# Global Debt & Fiscal Explorer

## Links

- Product page URL: https://www.agentpmt.com/marketplace/debt-fiscal-management
- Product markdown URL: https://www.agentpmt.com/marketplace/debt-fiscal-management?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/debt-fiscal-management?format=agent-json

## Overview

- Product ID: 6980e39971cad8f61bf5b211
- Vendor: Apoth3osis
- Type: data
- Unit type: request
- Price: 3000 credits
- Categories: Data Science, Financial Data, Data Processing, Finance & Accounting, Academic & Scientific Research, Public Records & Government Data, Civic Data & Demographics
- Generated at: 2026-05-21T08:23:38.332Z

### Page Description

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.

### Agent Description

Query national debt, government revenue, public expenditure, fiscal balance, and debt service data for any country or region. Get debt-to-GDP ratios, sustainability indicators, and time-series trends. Supports natural language country names and configurable time periods.

## Details

### Details

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.

### Actions

- `query_fiscal_data` (30 credits): Query national debt, government revenue, public expenditure, fiscal balance, and debt service data for any country or region from the World Bank.

### 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

### Workflows Using This Tool

No public workflows currently reference this product.

### Related Content

No related content is currently linked to this product.

## Integration Details

### DynamicMCP

- Setup page URL: https://www.agentpmt.com/dynamic-mcp
- Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to `https://api.agentpmt.com/mcp`. All tool execution happens in the cloud and the server cannot edit any files on your computer.

```bash
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

### REST API

The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials.

- Purchase endpoint: https://api.agentpmt.com/products/purchase
- Authorization format: `Bearer <base64(apiKey:budgetKey)>`

```bash
curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \
  -d '{
    "product_id": "6980e39971cad8f61bf5b211",
    "parameters": {
      "action": "query_fiscal_data",
      "fiscal_aspect": "all",
      "calculate_debt_ratios": true,
      "time_period": "latest"
    }
  }'
```

### Autonomous Agents

Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead.

- External Agent API page URL: https://www.agentpmt.com/external-agent-api
- External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md

### Schema

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "query_fiscal_data": {
      "description": "Query national debt, government revenue, public expenditure, fiscal balance, and debt service data for any country or region from the World Bank.",
      "properties": {
        "country_or_region": {
          "type": "string",
          "description": "Country name or region (e.g., 'United States', 'Greece', 'Kenya', 'World'). Defaults to 'World' if not provided.",
          "required": false
        },
        "fiscal_aspect": {
          "type": "string",
          "description": "Fiscal aspect to query: 'debt', 'balance', 'revenue', 'expenditure', 'debt_service', or 'all'. Defaults to 'all'.",
          "required": false,
          "default": "all",
          "enum": [
            "debt",
            "balance",
            "revenue",
            "expenditure",
            "debt_service",
            "all"
          ]
        },
        "calculate_debt_ratios": {
          "type": "boolean",
          "description": "Calculate debt sustainability ratios and compare against IMF/World Bank thresholds.",
          "required": false,
          "default": true
        },
        "time_period": {
          "type": "string",
          "description": "Time period: 'latest' for most recent data, a specific year like '2020', or a range like '2015:2020'.",
          "required": false,
          "default": "latest"
        }
      }
    }
  },
  "properties": {
    "action": {
      "type": "string",
      "description": "Use 'get_instructions' to retrieve documentation. Action to perform: query_fiscal_data",
      "required": false,
      "default": "query_fiscal_data",
      "enum": [
        "get_instructions",
        "query_fiscal_data"
      ]
    },
    "country_or_region": {
      "type": "string",
      "description": "Country name or region (e.g., 'United States', 'Greece', 'Kenya', 'World'). Defaults to 'World' if not provided.",
      "required": false
    },
    "fiscal_aspect": {
      "type": "string",
      "description": "Fiscal aspect to query: 'debt', 'balance', 'revenue', 'expenditure', 'debt_service', or 'all'. Defaults to 'all'.",
      "required": false
    },
    "calculate_debt_ratios": {
      "type": "boolean",
      "description": "Calculate debt sustainability ratios and compare against thresholds",
      "required": false,
      "default": true
    },
    "time_period": {
      "type": "string",
      "description": "Time period: 'latest' for most recent data, or specific year range like '2015:2020'",
      "required": false,
      "default": "latest"
    }
  }
}
```

### Usage 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:**
```json
{
  "country_or_region": "Kenya",
  "fiscal_aspect": "all",
  "time_period": "latest"
}
```

**Example — Debt sustainability analysis:**
```json
{
  "country_or_region": "Greece",
  "fiscal_aspect": "debt",
  "calculate_debt_ratios": true,
  "time_period": "latest"
}
```

**Example — Government revenue over time:**
```json
{
  "country_or_region": "United States",
  "fiscal_aspect": "revenue",
  "time_period": "2015:2023"
}
```

**Example — Expenditure breakdown:**
```json
{
  "country_or_region": "Nigeria",
  "fiscal_aspect": "expenditure",
  "time_period": "latest"
}
```

**Example — Fiscal balance for a specific year:**
```json
{
  "country_or_region": "Brazil",
  "fiscal_aspect": "balance",
  "time_period": "2022"
}
```

**Example — Debt service analysis:**
```json
{
  "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.

### Frequently Asked Questions

No linked FAQs are currently available.

### Dependencies

This product has no public dependency products.