{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_jraabq9f56z9","handle":"kapsarc-mcp-server","url":"https://wellknown.network/agents/kapsarc-mcp-server","links":{"self":"https://wellknown.network/agents/kapsarc-mcp-server/record.json","html":"https://wellknown.network/agents/kapsarc-mcp-server","markdown":"https://wellknown.network/agents/kapsarc-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/kapsarc-mcp-server","status":"https://wellknown.network/api/v1/agents/kapsarc-mcp-server/status","claim":"https://wellknown.network/agents/kapsarc-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/kapsarc-mcp-server/claim.json","badge":"https://wellknown.network/agents/kapsarc-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/kapsarc-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/kapsarc-mcp-server/tools"},"ard":{"identifier":"urn:air::server:kapsarc-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"kapsarc-mcp-server","summary":"MCP server for the KAPSARC Data Portal — search, query, export, and visualize energy/economic datasets","description":"# KAPSARC Data Portal MCP Server\n\nAn MCP server that connects LLMs to the [KAPSARC Data Portal](https://datasource.kapsarc.org) — search, query, export, and **visualize** energy and economic datasets via the Opendatasoft Explore API v2.1.\n\n## Tools\n\n### Data Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_datasets` | Free-text search of KAPSARC datasets |\n| `get_dataset` | Full metadata and field definitions for a dataset |\n| `get_records` | Query records with ODSQL filters |\n| `get_record` | Retrieve a single record by ID |\n| `get_dataset_facets` | Categorical field values and counts |\n| `get_catalog_facets` | Portal-wide themes, keywords, publishers |\n| `export_dataset` | Export without 100-record limit (JSON/CSV) |\n| `get_dataset_attachments` | List documentation/file attachments |\n| `export_catalog` | Bulk export all dataset metadata |\n| `list_export_formats` | Check available export formats |\n\n### Visualization Tools\n\n| Tool | Description |\n|------|-------------|\n| `visualize_dataset` | Fetch data and render a branded chart image |\n| `visualize_data` | Render a chart from pre-fetched records (no API call) |\n| `visualize_comparison` | Multi-series comparison charts (e.g. country vs country) |\n\nAll charts are returned as PNG images with official KAPSARC branding — logo, color palette, and source attribution. Chart types are auto-detected from data shape, or can be explicitly set to: `bar`, `hbar`, `line`, `pie`, or `scatter`.\n\n## Example Charts\n\n### Bar Chart — Top Oil Producers\n![Bar Chart](examples/bar_chart.png)\n\n### Line Chart — Time Series\n![Line Chart](examples/line_chart.png)\n\n### Pie Chart — Energy Mix\n![Pie Chart](examples/pie_chart.png)\n\n### Multi-Line — Production Comparison\n![Multi-Line Chart](examples/multiline_chart.png)\n\n### Scatter Plot — GDP vs Energy\n![Scatter Chart](examples/scatter_chart.png)\n\n### Horizontal Bar — Energy by Sector\n![Horizontal Bar Chart](examples/hbar_chart.png)\n\n### Electricity Prices\n![Electricity Prices](exa…","publisher":{"name":"MHDhazmi","url":null},"homepage":null,"repository":"https://github.com/MHDhazmi/kapsarc-mcp-server","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["datasets","energy","kapsarc","mcp","opendatasoft"],"pricing":null,"endpoints":[{"url":"pypi:kapsarc-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"analytics.reporting","name":"Reporting & Dashboards","confidence":0.836,"provenance":"derived"}],"categories":["analytics"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"kapsarc-mcp-server","registry":"pypi","observedAt":"2026-10-28T08:28:00.901Z","publishedAt":"2026-02-11T15:50:01.841489Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"kapsarc-mcp-server","url":"https://pypi.org/project/kapsarc-mcp-server/","firstSeenAt":"2026-09-09T22:23:03.745Z","fetchedAt":"2026-10-28T08:26:14.185Z","normalizedAt":"2026-10-28T08:26:14.185Z"}]},"firstSeenAt":"2026-09-09T22:23:03.745Z","updatedAt":"2026-10-28T08:28:00.901Z"}