# Watershed Climate MCP MCP > Watershed Climate lets your agent manage carbon accounting and emissions reporting for complex organizations. Upload activity data, track Scope 1, 2, and 3 inventories, monitor processing tasks, and generate compliance reports like CDP and TCFD without touching a dashboard. ## Overview - **Category:** the-unthinkable - **Price:** Free - **Tags:** carbon-accounting, emissions-tracking, sustainability, esg-reporting, climate-data, data-ingestion ## Description Stop manually wrestling with CSV uploads or navigating deep climate dashboards just to get your carbon metrics. This MCP connects your agent directly to your organization's full emissions lifecycle. You can initiate data ingestion by creating an upload container, adding activity records for things like electricity or travel, and then submitting the whole batch for calculation. The system handles validating that every record is clean before turning raw usage numbers into calculated Scope 1, 2, and 3 inventories. Need to check progress? Use a simple call to monitor any processing task. When the data is ready, you can instantly access generated reports or query specific emissions measurements by year. You don't have to manually copy figures from three different screens; your agent does it all in natural conversation. And when you need to combine this carbon footprint tracking with other systems—say, linking a billing MCP for costs to a messaging MCP for communications—the power of Vinkius allows your agent to chain these operations together through one single connection point. This gives you full visibility into every step, ensuring nothing happens in the dark. ## Tools ### create_upload Starts a new container to hold related activity data records that need processing. ### delete_upload_data_record Removes an incorrect or unwanted single record from an existing upload container. ### get_inventory Pulls detailed carbon footprint results and emissions composition for a specific inventory ID. ### get_report Retrieves the full details of a finished sustainability report, including generated files and scope summaries. ### get_task_status Checks if a submitted data processing task is complete, failed, or still running. ### get_upload Displays the general details for an upload container before any records are added or processed. ### list_inventories Lists all existing GHG inventories in your organization, showing total emissions per year and scope. ### list_measurements Finds all specific carbon footprint measurements across different years and inventories using filters. ### list_reduction_targets Shows the goals set for decreasing emissions over time, including baseline and target percentages. ### list_reports Lists every available formatted climate report in your organization by type or date. ### list_upload_data_records Reviews all activity data records currently held within a specific upload container. ### list_uploads Provides a list of all existing upload containers and their unique IDs for management. ### submit_upload Triggers the calculation engine to convert validated activity data into emissions measurements, returning a task ID. ### update_upload_data_record Corrects or modifies an existing activity record within an upload container before validation. ### upload_data_records Adds one or more new activity data records to a specified, pre-existing upload container. ### validate_upload Runs a quality check on the entire upload container to find errors before submission is allowed. ## Prompt Examples **Prompt:** ``` List all our GHG inventories and show me the total emissions for 2024. ``` **Response:** ``` I've found your GHG inventories. You have 2 inventories: 'FY2024 Global Operations' (Inventory ID: inv_2024_global) with total emissions of 12,450 tCO2e (Scope 1: 2,100, Scope 2: 3,850, Scope 3: 6,500) and 'FY2023 Global Operations' with 14,200 tCO2e. Your 2024 footprint shows a 12.3% reduction from 2023. Would you like a detailed breakdown by scope or emission source? ``` **Prompt:** ``` Create a new upload called 'Q1 2024 Electricity Data', add these 3 records: electricity usage for NYC office (50,000 kWh), London office (35,000 kWh), and São Paulo office (28,000 kWh) for January 2024, then validate and submit it. ``` **Response:** ``` I've completed the full data upload workflow: 1. Created upload 'Q1 2024 Electricity Data' (Upload ID: upl_q1_2024_elec) 2. Added 3 electricity records (NYC: 50,000 kWh, London: 35,000 kWh, São Paulo: 28,000 kWh) 3. Validated the upload — all records passed validation with no errors 4. Submitted for processing (Task ID: task_abc123) The task is currently processing. I can monitor the status for you. Would you like me to check the task status in a moment? ``` **Prompt:** ``` Show me our reduction targets and current progress toward our net-zero goal. ``` **Response:** ``` Here are your organization's reduction targets: 1. **SBTi 2030 Target** — Reduce absolute Scope 1+2 emissions by 50% by 2030 (baseline: 2019). Current progress: 28% reduction achieved. 2. **Net-Zero 2040 Target** — Achieve net-zero across all scopes by 2040. Current progress: 35% reduction from 2019 baseline. 3. **Scope 3 Target** — Reduce Scope 3 emissions intensity by 30% per unit of revenue by 2030. Current progress: 18% reduction. You're on track for the 2030 SBTi target at current reduction rate. Would you like a detailed emissions trend analysis? ``` ## Capabilities ### Manage Emission Inventories List and inspect your organization's total carbon footprint across Scope 1, 2, and 3 emissions. ### Generate Compliance Reports Access formatted disclosure documents for frameworks like CDP or TCFD using a specific report ID. ### Control Data Uploads Create new upload containers and add activity records to them, treating the process as a structured batch workflow. ### Track Calculation Status Check if a submitted data processing task is still running or if it failed, using a unique task ID. ### Query Specific Emissions Metrics Retrieve calculated carbon footprint values by filtering measurements based on inventory year or type. ## Use Cases ### Quarterly Reporting Cycle The ESG Analyst needs to file a CDP report by Friday. They ask their agent to find all available reports using `list_reports`, then request the detailed data for the most recent one using `get_report`. The agent pulls everything together, saving hours of manual compilation. ### New Data Source Integration The Ops Lead just bought a new facility and needs to add its electricity usage. They ask the agent to create a new upload container using `create_upload`, then use `upload_data_records` to submit the batch data for processing. ### Investigating Emissions Discrepancies The Climate Lead notices a large jump in Scope 3 emissions compared to last year. They ask the agent to list all inventories using `list_inventories` and then use `get_inventory` on the relevant ID to see exactly which scope is driving the change. ### Correcting Historical Data The analyst finds an error in a record from 2021. They first list the data records using `list_upload_data_records`, use `update_upload_data_record` to fix the quantity, and then repeat the validation/submission process. ## Benefits - Automate data preparation. Use `create_upload` to build a controlled container, then use `list_uploads` to see all existing containers for management. - Ensure accuracy before submitting. Always run `validate_upload` first; it checks the data quality and prevents submission failure. - Monitor processing in real time. After using `submit_upload`, you can check status with `get_task_status` until results are ready. - Get full scope visibility. Use `list_inventories` to see Scope 1, 2, and 3 totals for every year instantly. - Access historical data easily. Run `list_measurements` to query specific CO2e values across multiple years without guesswork. - Keep track of goals. Review configured targets using `list_reduction_targets` to see if current efforts meet net-zero commitments. ## How It Works The bottom line is, you talk to your AI client like talking to an analyst, and it handles the complex API calls needed to pull accurate climate data. 1. Connect your API key to this MCP via any compatible client. 2. Ask your agent to list all current GHG inventories, giving you the necessary IDs for context. 3. Have your agent request a specific report or inventory detail using those retrieved identifiers. ## Frequently Asked Questions **What is the workflow to upload activity data and get emissions calculated in Watershed?** The complete workflow is: (1) Use `create_upload` to create an upload container, (2) Use `upload_data_records` to add your activity data records (electricity, flights, shipping, etc.), (3) Use `validate_upload` to check data quality and fix any errors, (4) Use `submit_upload` to send data for emissions calculation, (5) Use `get_task_status` with the returned task_id to monitor processing. Once complete, your measurements appear in the inventory. **Can I check my organization's total carbon footprint for a specific year?** Yes! Use `list_inventories` to find your organization's GHG inventories by year. Then use `get_inventory` with the specific inventory_id to see the complete emissions breakdown by Scope 1 (direct), Scope 2 (energy), and Scope 3 (value chain). You can also use `list_measurements` with the year filter to see individual measurement details across all inventories. **Where do I find my Watershed API key and how do I generate one?** Log in to your Watershed dashboard at dashboard.watershedclimate.com, navigate to **Organization Settings** in the left menu, then go to the **API** section. Click to generate a new API key. Copy and save this key immediately — it won't be shown again. The key typically starts with `wh_`. Keep it secure as it provides full access to your organization's climate data. **What types of activity data can I upload to Watershed?** Watershed accepts a wide range of activity data including: electricity and energy consumption (kWh, therms), business travel (flights, hotels, rental cars), employee commuting, freight and shipping (ton-miles, kg-km), waste generated, water usage, and purchased goods/services. Each record needs fields like activity_type, quantity, unit, start_date, end_date, and optionally location and spend_amount for accurate emissions calculation. **How do I access my formatted annual reports or compliance disclosures using the `list_reports` tool?** You first use `list_reports` to see all generated documents, like CDP or TCFD summaries. Then, you call `get_report` with the specific report ID. This gives you full details on the files and scope covered by that disclosure. **My company set a new goal; how do I view or manage our emission reduction targets using `list_reduction_targets`?** Run `list_reduction_targets` to see all configured goals, including the baseline year and target percentage. If you need status updates on a specific commitment, check the details returned by that tool. **I found an error in my activity data; how do I correct or remove records before running `submit_upload`?** First, use `list_upload_data_records` to review the raw data. You can modify a record using `update_upload_data_record`, or delete unwanted entries with `delete_upload_data_record`. Remember, these changes must happen before validation. **When I run `submit_upload`, how do I know if the processing job finished correctly?** The submission generates a task ID. You track its status by calling `get_task_status` with that ID. This tells you immediately if the process is running, failed, or finally complete.