# 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 - 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-07-05T10:31:12.976Z ### 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 - ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp#platform=chatgpt - Cursor setup guide: https://www.agentpmt.com/dynamic-mcp#platform=cursor - Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp#platform=windsurf Use the local router for command-based MCP clients. It forwards requests to `https://api.agentpmt.com/mcp` and does not execute tools locally. ```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 ` ```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 Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below. - Autonomous Agent API reference URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents - Autonomous Agent API reference markdown URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents?format=agent-md - Credit-Based Access Using AgentAddress: https://www.agentpmt.com/docs/autonomous-agents/credit-based-tool-usage-with-agentaddress - AgentAddress is preferred for persistent file access, stored platform state, and maximum tool use ability across repeated calls. - Direct x402 is for independent one-off tool calls that do not require shared files or stored platform state. - Direct x402 public payments: USDC on Base, Arbitrum, Optimism, Polygon, and Avalanche. #### Product Skill Package This product has a published Agent Skill package for product-specific operating instructions. - Skill slug: global-debt-fiscal-explorer - Version: 1.0.0 - Download SKILL.md: https://raw.githubusercontent.com/AgentPMT/agent-skills/main/skills/global-debt-fiscal-explorer/SKILL.md - Package source: https://github.com/AgentPMT/agent-skills/tree/main/skills/global-debt-fiscal-explorer - OpenClaw listing: https://clawhub.ai/agentpmt/global-debt-fiscal-explorer - OpenClaw install: `openclaw skills install global-debt-fiscal-explorer` - skills.sh install: `npx skills add AgentPMT/agent-skills --skill global-debt-fiscal-explorer` - Last published: 2026-06-24T06:03:24.451Z ### 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 #### How do I connect this tool to an external agent? - Page URL: https://www.agentpmt.com/faq - Markdown URL: https://www.agentpmt.com/faq?format=agent-md You can install the local MCP server by opening a terminal and running: ``` npm install -g @agentpmt/mcp-router agentpmt-setup ``` This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc. Alternatively you can connect to the hosted version with this config block, no installation required: ``` { "mcpServers": { "agentpmt": { "type": "streamable-http", "url": "https://api.agentpmt.com/mcp", "headers": { "Authorization": "Bearer ", "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}" } } } } ``` [View MCP Connection Instructions](/docs/mcp-reference/connection) for more details. #### How does an external agent use this tool? - Page URL: https://www.agentpmt.com/faq - Markdown URL: https://www.agentpmt.com/faq?format=agent-md After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent: > Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get\_instructions' so you know how to use the tool search interface. Then call action 'get\_schema' with tool\_id 6980e39971cad8f61bf5b211 ("Global Debt & Fiscal Explorer"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT. ### Dependencies This product has no public dependency products.