Skip to main content
The Mangrove MCP server enables you to query your MRV data using natural language through AI assistants like Claude and Cursor. Instead of manually exporting data and building custom queries, you can ask questions conversationally and receive structured insights from your production, accounting, and inventory data.

​
What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and APIs. The Mangrove MCP server implements this protocol, providing a bridge between your Mangrove account and MCP-enabled tools.
MCP connections are read-only and respect your existing Mangrove API permissions. All queries are authenticated using your Mangrove API key.

​
Use Cases

The MCP integration is particularly useful for:
  • Ad-hoc reporting: Query specific metrics without building custom dashboards
  • Data validation: Quickly audit data completeness and identify gaps
  • Trend analysis: Ask questions about patterns across time periods or locations
  • Cross-referencing: Correlate data across events, batches, and locations

​
Available Data

The MCP server provides access to all Mangrove API endpoints. You can query:

Production Data

Projects, locations, feedstocks, event types, events, data points, and evidence files

Accounting & Reporting

Batches, ledger transactions, reports, models, and model runs

Inventory Management

Orders, issuances, retirements, and transfers

Account Administration

Account settings, user roles, and custom fields
For detailed information about each endpoint, see the API Reference sections.

​
Setup

​
Prerequisites

To connect to the Mangrove MCP server, you’ll need:
  1. Mangrove API Key: Generate a read-only API key as an Account Admin in API Settings
  2. MCP Auth Token: Available in your MCP Settings
  3. MCP Server URL: Available in your MCP Settings
MCP server URLs and authentication tokens are unique to your organization. Contact your Implementation Engineer to have MCP Settings enabled in your account.

​
Claude Desktop Setup

1

Locate your Claude Desktop configuration

The configuration file location varies by operating system:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
If the file doesn’t exist, create it.
2

Add the Mangrove MCP server

Add the following configuration to your claude_desktop_config.json:
{
  "mcpServers": {
    "mangrove": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "YOUR_MCP_SERVER_URL",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_TOKEN}",
        "--header",
        "X-Mangrove-Token:${MANGROVE_API_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "Bearer YOUR_AUTH_TOKEN",
        "MANGROVE_API_TOKEN": "YOUR_MANGROVE_API_KEY"
      }
    }
  }
}
Replace the placeholders:
  • YOUR_MCP_SERVER_URL: Provided by your Implementation Engineer
  • YOUR_AUTH_TOKEN: Provided by your Implementation Engineer
  • YOUR_MANGROVE_API_KEY: Your API key from Mangrove API Settings
3

Restart Claude Desktop

Close and reopen Claude Desktop to load the new configuration.
4

Verify the connection

In Claude Desktop, you should now see the Mangrove MCP server available. Try a simple query:“What projects do I have access to in Mangrove?”

​
Cursor IDE Setup

1

Open Cursor settings

Navigate to Cursor Settings > Features > Model Context Protocol
2

Add a new MCP server

Click “Add Server” and enter the following configuration:
{
  "name": "mangrove",
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "YOUR_MCP_SERVER_URL",
    "--transport",
    "http-only",
    "--header",
    "Authorization:${AUTH_TOKEN}",
    "--header",
    "X-Mangrove-Token:${MANGROVE_API_TOKEN}"
  ],
  "env": {
    "AUTH_TOKEN": "Bearer YOUR_AUTH_TOKEN",
    "MANGROVE_API_TOKEN": "YOUR_MANGROVE_API_KEY"
  }
}
Replace the placeholders with your credentials as described in the Claude Desktop setup.
3

Enable the server

Toggle the Mangrove MCP server to “enabled” in your Cursor settings.
4

Test the integration

Open a new chat in Cursor and ask:“Show me all events from the last week for project [your-project-id]“

​
Example Prompts

Once connected, you can use natural language to query your Mangrove data. Here are example queries organized by common use cases:

​
Production & Operations

"Show me all events from project abc123 in the last 30 days that are missing data points"

"What locations are associated with project xyz789 and when was the last event recorded at each?"

​
Accounting & Compliance

"List all batches created in Q4 2024 with their CI scores, grouped by feedstock type"

"Which events from location loc_xyz have missing evidence files that I need for the upcoming audit?"

​
Analysis & Insights

"Compare the average mass flow rates across my three production locations over the past quarter"

"Show me the trend in CI scores for corn feedstock over the last 6 months"

​
Inventory & Credits

"What's the total volume of credits issued, retired, and transferred in 2024 for project abc123?"

"Show me all pending orders and their current status"

​
Important Considerations

AI-generated insights are produced by language models interpreting your Mangrove data. While powerful for exploration and analysis, always verify critical results against source data. MCP responses should complement, not replace, human judgment for compliance and reporting decisions.
The underlying data returned from Mangrove APIs is accurate and reflects your system of record. However, the AI assistant’s interpretation and summary of that data may occasionally contain inaccuracies or miss nuanced details.