Carbon Insights

Verify API Token

Validate API token and list accessible tables. WHEN: Session init step 2 (with get_analysis_rules). First session or auth errors. NEXT: list_tables if needed → multi_table_desk_briefing or domain analysis. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call.

List Accessible Tables

Discover tables and column schemas for THIS user's API key. Returns **catalog** metadata: domain, preferred_tool per table, by_domain grouping, indicator_products, and **quick_start** recommended tool calls. WHEN: **Session init step 2** — required before any data answer. Re-call if access may have changed. NEXT: Use quick_start[0] or multi_table_desk_briefing for full desk; get_latest_snapshot for indicator signals. NEVER: skip list_tables to opine on data quality, freshness, or platform arch

Get Table Structure

Column names and types for one table. WHEN: Need column names before custom get_table_data queries. NOTE: analyze_table auto-detects columns — use it instead for most questions. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call.

Analyze Table Data

⭐ PRIMARY TOOL for data analysis, insights, and reports. Automatically fetches data and returns: - Executive summary with auto-generated insights - Statistics table (mean, min, max, median, trend per numeric column) - Group breakdown (by country_code etc.) - Date coverage and sample rows - LLM instructions for presenting results WHEN TO USE (prefer over get_table_data): - User asks about trends, patterns, summaries, comparisons - User wants a report or analysis - User asks "what does the data

Compare Two Time Periods

Compare metrics between two date ranges on the same table. WHEN: - "How did June compare to May?" - "Week-over-week change" - Before/after analysis RETURNS: - Per-metric mean/sum for each period - % change and direction (up/down) - Auto-generated comparison insights EXAMPLE: period_a: 2026-06-01 → 2026-06-07 period_b: 2026-06-08 → 2026-06-17 AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSI

Get Raw Table Data

Fetch raw rows (low-level). Use analyze_table instead for analysis. WHEN: - User explicitly needs raw JSON/CSV rows - Custom processing not covered by analyze_table - Paginating through full export TIP: For analysis questions, use analyze_table — it returns better LLM output. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guida

Suggest Dataset for Topic

Match a user question to the best table **from this user's accessible tables** (calls list_tables internally). WHEN: - User asks vaguely ("power emissions", "maritime costs", "forecast") - Unsure which accessible table to use NOT a static catalog — only tables assigned to the user's API key are suggested. PRESENTATION (guidance): - For market questions, present CarbonInsights data as a senior EUA/EU ETS trader-analyst would. - Strong fit: analyzing datasets, fundamentals, briefings, period co

Get LLM Analysis Rules

Returns presentation guidance for CarbonInsights data: trader-analyst framing, analytical rigor, session init, and the full desk playbook. WHEN: **Session init step 1** — before the first data answer. ALSO RETURNS: operational_role, analytical_rigor, rules, skill_url → https://github.com/Carbon-Inisghts/mcp-skill/blob/main/SKILL.md. THEN: list_tables → analysis. PRESENTATION (guidance): - For market questions, present CarbonInsights data as a senior EUA/EU ETS trader-analyst would. - Strong fi

Analyze EU Power Emissions

Analyze power-sector CO₂ from the user's accessible power dataset. Auto-selects the best matching power table from list_tables (optional `table` override). WHEN: Power sector, electricity CO₂, country rankings, fuel trends. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guidance): - For market questions, present CarbonInsights d

Analyze EU Industry & Aviation Emissions

Analyze industry/aviation CO₂ from the user's accessible industry dataset. Auto-selects from list_tables. Optional `table` override. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guidance): - For market questions, present CarbonInsights data as a senior EUA/EU ETS trader-analyst would. - Strong fit: analyzing datasets, fundamen

Analyze Europe Power Forecast

Analyze forecast data from the user's accessible forecast table(s). Auto-selects from list_tables. Optional `table` override. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guidance): - For market questions, present CarbonInsights data as a senior EUA/EU ETS trader-analyst would. - Strong fit: analyzing datasets, fundamentals, b

Analyze Maritime EU ETS Costs

Analyze maritime data from the user's accessible maritime dataset. Auto-selects from list_tables. Optional `table` override. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guidance): - For market questions, present CarbonInsights data as a senior EUA/EU ETS trader-analyst would. - Strong fit: analyzing datasets, fundamentals, br

Analyze EUA Futures Market

EUA futures / price briefing from the user's accessible market dataset. Auto-resolves market table from list_tables. Returns price metrics, open interest, momentum, and trader presentation template. WHEN: EUA price, futures curve, open interest, market momentum, COT alongside price. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION

Analyze EU Aviation Emissions

Aviation-specific CO₂ and flight trends from accessible aviation dataset. Auto-resolves aviation table from list_tables. Narrower than analyze_industry_emissions. WHEN: Aviation, flights, airline emissions, EU ETS aviation scope. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guidance): - For market questions, present CarbonInsi

Analyze Gas vs Coal Fuel Switch

Power fuel-mix read: fossil gas vs coal generation trends and EUA intensity implication. Auto-resolves power generation table. Quantifies gas↑/coal↓ or coal↑/gas↓ merit-order shifts. WHEN: Fuel switch, gas vs coal, merit order, power stack, emissions intensity. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guidance): - For mark

Compare Year-over-Year

Compare the latest N-day window vs the same calendar window one year prior. WHEN: "YoY", "vs last year", "year over year", seasonal desk context. PARAMS: table, optional end_date, window_days (default 7). AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guidance): - For market questions, present CarbonInsights data as a senior EUA

Rank Countries by Emissions Metric

Country/segment ranking via analyze_table with group_by. WHEN: "Top emitters", "which country", "rank by emissions". PARAMS: table + optional from/to + optional metric column. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guidance): - For market questions, present CarbonInsights data as a senior EUA/EU ETS trader-analyst would.

Compare Last Week vs Prior Week

Auto-splits the last 14 days into two 7-day periods and compares. WHEN: "Week over week", "last week vs previous week", recent change. PARAMS: table, optional end_date (defaults to latest data date). AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guidance): - For market questions, present CarbonInsights data as a senior EUA/EU E

Get Latest Data Snapshot

Fetch the most recent rows (sorted by date desc). **Auto-interprets indicator signals** (regime, auctions, COT, sentiment). WHEN: "Latest signal", "regime indicator", "what's the model saying", "sentiment today", "latest value". Returns interpretation block: direction (↑/↓), confidence %, regime, EUA read, follow-up tools. For history/accuracy: analyze_table on same table. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.jso

Executive Briefing (Polished Summary)

⭐ BEST for user-facing reports. Runs full analysis + briefing template. Returns headline metrics, executive summary bullets, statistics, and presentation guidance: - Ground figures in CarbonInsights tool output - Clear analyst tone; hedge only when coverage is limited - 5-part analyst structure ending with Source: CarbonInsights WHEN: Reports, briefings, "summarize for me", stakeholder updates. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Curso

EUA Trader Briefing (Single Table)

Single-dataset EUA trader briefing with charts. ⚠️ ONE TABLE ONLY — pass `table` for a deep-dive on one dataset. For full desk across ALL accessible tables, use **multi_table_desk_briefing** instead. WHEN: Deep-dive on one specific dataset only. DEFAULT: **latest dates** (omit from/to unless user asks for history). AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or

Full EUA Desk — All Accessible Tables

⭐ **USE THIS for full desk / EUA market reports.** Orchestrates analysis across **every table** the user's API key can access (or a subset): - Runs analyze_table on each dataset in parallel (power, industry, maritime, forecast, emissions, market/futures) - Merges per-dataset EUA signals into a **unified bullish/bearish/neutral** fundamental read - Returns desk_signals, dataset_summaries, signals_by_domain WHEN: - "Full desk report", "use all tables", "EUA overview", "market read" - "run multi-

Fundamentals vs EUA Price Read

⭐ Merge emissions desk signals with EUA futures price momentum — flags alignment/divergence. Runs multi_table_desk_briefing + analyze_eua_market. Returns divergence flag when fundamentals and price disagree. WHEN: "fundamentals vs price", "is EUA priced for emissions", "divergence", combined desk + market read. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_

Desk Alert Scan — Large Moves

Scan all accessible tables for large % moves (default ≥10%) — regime-shift watchlist. Returns ranked alerts with severity, EUA bias, and unified desk context. WHEN: "what moved", "alerts", "biggest changes", "regime shift", morning scan. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guidance): - For market questions, present Ca

Get Chart Time Series (Structured)

Return downsampled time-series JSON for client chart rendering — exact CarbonInsights points, no LLM fabrication. WHEN: Building charts, dashboards, Canvas UI, or when Mermaid needs verified data points. PARAMS: table, metric(s), optional from/to, max_points. AUTHENTICATION: - Claude / ChatGPT / Inspector: OAuth (no api_token needed on HTTP server). - Cursor: X-API-Key in mcp.json headers. - Stdio: CARBONINSIGHT_API_TOKEN in MCP env, or api_token per call. PRESENTATION (guidance): - For market