EcoCheck for ChatGPT and Claude — documentation

EcoCheck is a greenhouse-gas (GHG) inventory and EU CBAM platform used by Vietnamese manufacturers, exporters and their consultants. The EcoCheck connector lets ChatGPT, Claude and other AI assistants read and update the user's EcoCheck data — record activity data, build ISO 14064-1 and Decree 06/2022 inventories, compute EU CBAM costs and embedded emissions — with the same permissions the user has on ecocheck.ai.

Account connector (sign-in): https://ecocheck.ai/mcp/account

Public tools (no account): https://ecocheck.ai/mcp

Transport: MCP Streamable HTTP. Authentication: OAuth 2.1 authorization code + PKCE (S256), dynamic client registration.

Set up

ChatGPT

Open ChatGPT → Settings → Apps (Connectors). Find EcoCheck in the directory, or create a custom connector with the URL above (Developer mode).
Click Connect, sign in with your EcoCheck account and approve the requested access.
In a chat, ask for example: “List my EcoCheck workspaces”.

Claude (claude.ai, desktop, mobile)

Settings → Connectors → Browse connectors → EcoCheck, or Add custom connector with https://ecocheck.ai/mcp/account.
Click Connect and sign in with your EcoCheck account.

Claude Code, Cursor, VS Code and other MCP clients

claude mcp add --transport http ecocheck https://ecocheck.ai/mcp/account, then run /mcp and sign in. Any MCP client that supports remote servers with OAuth works the same way.

Authentication and permissions

Sign-in happens on EcoCheck's own login page (AWS Cognito). The AI assistant never sees the user's password; it receives a short-lived access token (1 hour) and a refresh token (7 days).
Scopes: ecocheck/read (read-only) and ecocheck/write (create and update). The user chooses when connecting.
The workspace owner controls AI access in EcoCheck → Workspace → AI assistant: turn AI on or off for the whole workspace and set each member's level — View only (default), View and edit, or Full access (delete records, manage members). Effective rights are the lower of the token scope, the member's AI level and the member's own role in EcoCheck.
Every tool call is written to the workspace audit log (who, which tool, when, allowed or refused), which the owner can filter and export as CSV.
The owner can disconnect AI for one member or for the whole workspace at any time; existing tokens stop working immediately.
Destructive tools (delete_records, remove_member) are annotated as destructive and require an explicit confirm argument.

Tools

Read (scope ecocheck/read)

`list_workspaces`	List the workspaces (subscriptions) of the signed-in user
`get_my_access`	Profile and the AI access level set by the workspace owner
`ecocheck_guide`	How-to guidance: activity data, CBAM workflow, permissions, data model, Scope 3
`get_organizations`	Organizations, their facilities, inventories and members
`get_facility`	Facility details
`get_inventories`	GHG inventories and reporting years
`get_emission_accounts`	Emission sources of an inventory year
`get_journals`	Recorded activity data
`get_emissions_report`	Emissions by scope, ISO 14064-1 category, gas, source and month
`preview_emission`	Compute emissions for activity data without saving
`lookup_reference`	Emission factors, units, GWP sets, templates and other reference data
`get_targets`	Reduction targets and actions
`get_assessments`	Significance and accuracy assessments
`get_cbam`	EU CBAM installations, goods, production routes and results
`get_workspace_admin`	Members, AI access levels and audit log (workspace owner only)
`export_report`	Export a Word inventory report (Decree 06/2022 or ISO 14064-1 template)

Write (scope ecocheck/write and AI level View and edit or Full access)

`save_organization / save_facility / save_inventory`	Create or update the inventory structure
`manage_inventory_year`	Add, clone or change the status of a reporting year
`save_emission_account / add_accounts_from_template`	Create emission sources, or add them from a template
`record_activity / update_journal`	Record or correct activity data (fuel, electricity, refrigerants…)
`save_custom_factor`	Create or update a custom emission factor
`save_target / save_reduction_action`	Reduction targets and actions
`save_assessment`	Significance and accuracy scores
`save_cbam_data / run_cbam_action`	EU CBAM data, specific embedded emissions (SEE) calculation, communication template
`invite_member`	Invite a member or change a role (Full access level only)
`delete_records / remove_member`	Delete records or remove a member: destructive, Full access level only, always asks for explicit confirmation

Public tools at https://ecocheck.ai/mcp (no sign-in)

`check_ghg_inventory_obligation`	Is a Vietnamese facility on the mandatory GHG inventory list (Decision 42/2026/QD-TTg)?
`cbam_scope_check / cbam_default_value / estimate_cbam_cost`	EU CBAM scope by CN code, EU default values, certificate cost estimate
`calculate_ghg_inventory / ghg_emission_factors / iso14064_guide`	Quick ISO 14064-1 calculation, emission factors, guidance
`get_ghg_regulations`	Vietnamese GHG regulations and deadlines
`search_ecocheck / list_articles / get_article / get_pricing / list_services / about_ecocheck`	EcoCheck content, pricing and services

Every tool declares MCP annotations (read-only, destructive, idempotent, open-world) and a human-readable title.

Example prompts

“Record September data for the rolling mill: electricity 182,400 kWh, diesel for the generator 1,250 litres, LPG 3.2 tonnes.”
“What are our 2026 emissions by scope so far? Which source is the largest?”
“How much CBAM would an EU importer pay for 12,000 t of hot-rolled coil, CN 7208 39 00, in 2026?”
“Prepare the Q1 ISO 14064-1 inventory report and export it as Word.”
“Who in our workspace can use AI, and what did the assistant change this week?” (workspace owner)

Troubleshooting

“AGENT_LEVEL_TOO_LOW”: the workspace owner set your AI level to View only. Ask them to raise it.
“AGENT_SCOPE_TOO_LOW”: you connected read-only. Disconnect and reconnect EcoCheck, allowing changes.
“AGENT_AGENTS_DISABLED” / “AGENT_DISCONNECTED”: AI was turned off or your connection was revoked by the owner.
No organizations returned: you are not a member of any organization in that workspace; the organization owner manages membership.

Support

Email [email protected] or call +84 37 6869 366 (Mon–Fri, 8:30–17:30 ICT). We reply within one business day. Machine-readable details: /auth.md, OAuth metadata, llms.txt.

EcoCheck is a product of BeevR Technology Co., Ltd., 125 Hoang Ngan, Trung Hoa, Cau Giay, Hanoi, Vietnam. Last updated October 8, 2026.