Weather data, designed for machines

A fully autonomous onboarding flow. No human intervention required. Create an account, accept terms, add credits, and start querying — all via API.

Get Started OpenAPI Spec

How it works

Three steps to production

Create & Test

POST to /accounts to get a stage API key. Test any endpoint with zero credit cost and generous rate limits.

Accept & Fund

Accept terms of service, set up billing, and purchase a credit bundle. All via API.

Go Live

Generate a production key and start querying. Normalized weather data with full metadata on every response.

MCP Server

Native tools for your AI editor

Install the Virga MCP server to give your AI assistant direct access to weather data. Works with Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and more.

Claude Code

claude mcp add --transport stdio --env VIRGA_API_KEY=sk_virga_prod_xxx virga-weather -- npx -y @virga-mcp/server

Codex CLI

codex mcp add virga-weather --env VIRGA_API_KEY=sk_virga_prod_xxx -- npx -y @virga-mcp/server

Gemini CLI

gemini mcp add virga-weather -- npx -y @virga-mcp/server --api-key sk_virga_prod_xxx

Also supports Claude Desktop, Cursor, Windsurf, OpenCode, and Xcode 26.3+. See docs for JSON config examples.

REST API

From zero to weather data

Create an account

curl -X POST https://api.virga.dev/api/v1/accounts \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'

Query weather data

curl https://api.virga.dev/api/v1/weather/current \
  -H "X-API-Key: sk_virga_stage_your_key_here" \
  -G -d "lat=51.5&lon=-0.12"

Pricing

Prepaid credits, simple math

Buy credit bundles via API. Each API call deducts credits based on complexity. Stage environment is always free.

500

credits

$0.010 / credit

Popular

2,000

credits

$18

$0.009 / credit

10,000

credits

$75

$0.0075 / credit

Credits per call

Endpoint	Credits
/weather/current	1
/weather/forecast/hourly	2
/weather/forecast/daily	2
/weather/historical	3
/weather/batch	sum