Skip to main content

MCP server for the Jiskta Climate & Environmental Data API

Project description

jiskta-mcp

PyPI License: MIT

MCP server for the Jiskta Climate & Environmental Data API. Gives AI assistants direct access to historical air quality, ERA5 meteorology, water risk, geocoding, and industrial facility data — without writing any code.

What is MCP?

Model Context Protocol is an open standard that lets AI tools (Claude Desktop, Cursor, Cline, Copilot Workspace) call external APIs in conversation. This package runs on your machine, not on any server — it just proxies calls to the Jiskta API using your API key.

Quickstart

Get an API key: jiskta.com/dashboard — free credits included on signup.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "jiskta": {
      "command": "uvx",
      "args": ["jiskta-mcp"],
      "env": {
        "JISKTA_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

No Python installation needed — uvx downloads and runs the package automatically.

Cursor / Cline / other MCP clients

Use the same config format your tool supports. The command is always uvx jiskta-mcp with JISKTA_API_KEY set.

Manual install

pip install jiskta-mcp
export JISKTA_API_KEY=sk_live_...
jiskta-mcp

Available tools

Tool Description
query_climate Historical air quality + ERA5 met data for a bounding box
query_climate_point Same, for a single lat/lon point
estimate_query_cost Dry-run — check credit cost before querying
geocode Address → coordinates (113M housenumbers, global)
reverse_geocode Coordinates → nearest address
enrich_location Coordinate → NUTS3 region + WRI water risk + nearest facility
water_risk WRI Aqueduct 4.0 water risk for a bounding box
find_facilities Nearest E-PRTR industrial facilities within a radius
get_coverage Check available data months before querying
spatial_link Aggregate raster data to NUTS3 regions or countries

Example conversations

Once connected, you can ask things like:

"What was the average NO₂ level in Brussels in 2023?"

"Is there any industrial pollution risk near Industrieweg 1, Antwerp?"

"Compare PM2.5 trends across NUTS3 regions in the Ruhr area from 2018 to 2023."

"What's the water stress level for our distribution centre at 51.5°N, 4.3°E?"

"How many days did PM10 exceed the EU limit in Paris last year?"

Data sources

  • Air quality: Copernicus CAMS EU reanalysis (0.1°, 2013–present) and CAMS Global (0.75°, 2020–present)
  • Meteorology: ECMWF ERA5 reanalysis (0.25°, 2013–present)
  • Water risk: WRI Aqueduct 4.0 (2023), global
  • Industrial facilities: EEA E-PRTR, ~97,000 EU facilities (CC BY 4.0)
  • Geocoding: OpenStreetMap (CC BY-SA)

Pricing

Credits are consumed per tile scanned (geographic area × time period × variable). Use estimate_query_cost before large queries. Top up at jiskta.com/dashboard.

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jiskta_mcp-0.1.0.tar.gz (8.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jiskta_mcp-0.1.0-py3-none-any.whl (9.2 kB view details)

Uploaded Python 3

File details

Details for the file jiskta_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: jiskta_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 8.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.12

File hashes

Hashes for jiskta_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 fb05d3fbcfdb6fcb00c96d4b7c4827698f82c1f0acf77565815062edfa4c3b96
MD5 fcbf6c126b0b63cb0b7c545c25ac1855
BLAKE2b-256 f4d920ab83f36e64c406d14f63d9cc55df990b45c5e25b1b5d3e97e64e022604

See more details on using hashes here.

File details

Details for the file jiskta_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: jiskta_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 9.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.12

File hashes

Hashes for jiskta_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d56c7c5712563a0d643162bd89485190fd8aa6467b2dfc8a4667f57a205d2de6
MD5 c7a9424e5a144be7a491bd28259cc472
BLAKE2b-256 b4beb5335752318d932700a1d72785dde5ff38bfa7be284ef8b21d63a481b719

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page