Docs/Skills/GDP Data Skill

GDP Data Skill

Global GDP data by country

OperationalCredits 2 per callp50 201msFinance

Overview

GDP API provides comprehensive economic data from the World Bank including GDP in current USD, GDP growth rate, and GDP per capita. Query the latest data or retrieve data for a specific year for economic analysis and research. With changes=true every reading is set against the country's own stored history: whether GDP rose or fell for every plan, and on paid plans the previous year, its GDP and real growth rate, the change in dollars and percent, the per-capita change, a growth trend (accelerating, slowing or steady), the 5-year average real growth rate, and the 5- and 10-year compound annual growth rates of nominal GDP.

Live Test GDP Data Skill Skill →

The tool

Once your client is connected to the VerveKit server, this appears in its tool list as GDPDataSkill. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.

Tool call
{
  "name": "GDPDataSkill",
  "arguments": {
    "country": "US"
  }
}

You do not name the tool yourself; the model picks it. Asking about US in the terms this skill covers is enough for it to reach for GDPDataSkill on its own — naming it explicitly also works, and is the way to force the call.

Connecting

One server URL covers every skill in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.

{
  "mcpServers": {
    "vervekit": {
      "url": "https://api.vervekit.com/v1/mcp"
    }
  }
}

Per-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.

Arguments

These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.

ArgumentTypeDescription
countryRequiredstringISO 2 or 3-letter country code (e.g., US, USA, GB, GBR)
length 2–3
yearOptionalPremiumintegerSpecific year to retrieve data for (1960-present). Returns latest if not specified.
range 1960–2030
changesOptionalbooleanInclude the change against the previous year, the growth trend, the 5-year average growth rate and the 5- and 10-year compound annual growth rates

What the model gets back

The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.

Result
{
  "status": "ok",
  "error": null,
  "data": {
    "country": "US",
    "countryName": "United States",
    "currency": "USD",
    "year": 2025,
    "gdp": 30769700000000,
    "gdpFormatted": "$30.77 trillion",
    "gdpGrowth": 2.16,
    "gdpPerCapita": 90027,
    "count": 1,
    "years": [
      {
        "year": 2025,
        "gdp": 30769700000000,
        "gdpFormatted": "$30.77 trillion",
        "gdpGrowth": 2.16,
        "gdpPerCapita": 90027
      }
    ],
    "previousYear": 2024,
    "changeDirection": "up",
    "previousGdp": 29298013000000,
    "gdpChange": 1471687000000,
    "gdpChangePercent": 5.02,
    "previousGdpGrowth": 2.79,
    "growthTrend": "slowing",
    "gdpPerCapitaChangePercent": 4.48,
    "gdpCagr5y": 7.56,
    "gdpCagr10y": 5.34,
    "averageGrowth5y": 3.31
  },
  "code": 200
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

FieldTypeExampleDescription
countrystringUSISO country code of the queried country
countryNamestringUnited StatesFull name of the country in English
currencystringUSDOfficial currency code for the country
yearnumber2025Year for which GDP data is provided
gdpnumber30769700000000Gross Domestic Product in current USD
gdpFormattedstring$30.77 trillionFormatted GDP value (e.g., $27.36 trillion)
gdpGrowthnumber2.16Annual GDP growth rate as percentage
gdpPerCapitanumber90027GDP per capita in current USD
countPremiumnumber1Number of year records returned
yearsPremiumarray[1]Array of GDP records for multiple years
years.0.yearPremiumnumber2025Year of the GDP data record
years.0.gdpPremiumnumber30769700000000Gross Domestic Product in current USD
years.0.gdpFormattedPremiumstring$30.77 trillionFormatted GDP value (e.g., $27.36 trillion)
years.0.gdpGrowthPremiumnumber2.16Annual GDP growth rate as percentage
years.0.gdpPerCapitaPremiumnumber90027GDP per capita in current USD
previousYearPremiumnumber2024Year of the previous GDP record, the year before the reading (with changes=true)
changeDirectionstringupWhether GDP rose, fell or held against the previous year: up, down or unchanged (with changes=true)
previousGdpPremiumnumber29298013000000GDP in current USD for the previous year (with changes=true)
gdpChangePremiumnumber1471687000000Change in GDP from the previous year, in current USD (with changes=true)
gdpChangePercentPremiumnumber5.02Percent change in nominal GDP (current USD) from the previous year; gdpGrowth is the real, inflation-adjusted rate (with changes=true)
previousGdpGrowthPremiumnumber2.79Real GDP growth rate for the previous year, as a percentage (with changes=true)
growthTrendPremiumstringslowingWhether real growth is accelerating, slowing or steady against the previous year's rate (with changes=true)
gdpPerCapitaChangePercentPremiumnumber4.48Percent change in GDP per capita (current USD) from the previous year (with changes=true)
gdpCagr5yPremiumnumber7.56Compound annual growth rate of nominal GDP over the 5 years ending at the reading, as a percentage (with changes=true)
gdpCagr10yPremiumnumber5.34Compound annual growth rate of nominal GDP over the 10 years ending at the reading, as a percentage (with changes=true)
averageGrowth5yPremiumnumber3.31Average real GDP growth rate over the 5 years ending at the reading, as a percentage; null unless all 5 years are reported (with changes=true)

Failure modes

Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.

StatusWhat it means
400 / 422The arguments did not validate. The message names the offending one.
401The OAuth session is invalid or expired — reconnect the server.
403Blocked by a key restriction or an IP allow-list. Never a bad identity.
404This skill is not part of VerveKit. Check the catalog.
429Out of credits, or a brief rate limit. The message tells them apart.

A call costs 2 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.

Use cases

Sovereign Risk Assessment
To assess national debt sustainability, credit rating agencies compare a government's outstanding obligations against total economic output and per capita income.
Cross-Border Expansion Benchmarking
When evaluating consumer purchasing power in emerging markets, retail strategists benchmark local gross domestic product per capita against established regional markets.
Macroeconomic Dashboard Widgets
Feed annual growth rates and formatted dollar outputs directly into financial intelligence portals to track national output shifts across continents.
Academic Research Modeling
Economists track multi-decade development trajectories by pulling historical national production numbers and yearly growth percentages for statistical regression models.

Other ways to use GDP Data Skill

Set up GDP Data Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.

Call it as a REST APIOne HTTPS endpoint and an x-api-key header, with SDKs for Node, Python and .NET.APIVerve →Reference →
Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheets →Reference →
Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.VerveContext →Reference →

More in Finance:

Was this page helpful?