CrbonFreeCrbonFree
@crbonfree/mcpBuild on your numbers

Give your AI agent secure access to your dashboard.

Connect a remote-capable agent to the hosted CrbonFree MCP server. OAuth 2.1 signs the user in, every read is checked against their organization membership, and supporting chat apps show the answer as an interactive view.

Remote MCP server URL

https://api.crbonfree.com/mcp
Open the dashboardRead the API reference
illustrative session, example numbers

15

read-only tools, none of them writes

3

interactive views in chat apps that support MCP Apps

4,500+

MCP local npm package downloads with no paid marketing

Deprecated

Crbon Labs, 2026

1

remote endpoint for every supported MCP client

What is the MCP server?

The CrbonFree remote MCP server is a hosted Model Context Protocol endpoint for chat apps and coding agents. OAuth 2.1 signs the user in, and 15 read-only tools return usage, carbon, billing, invoices, statements and receipts for the organizations that user belongs to, as text or, in apps that support MCP Apps, as an interactive view.

Last checked against the product on 14 October 2026. Carbon figures follow methodology v1.2.

At a glance
Endpoint
https://api.crbonfree.com/mcp
Transport
Remote HTTP MCP (Streamable HTTP)
Authentication
OAuth 2.1 bearer token
Discovery
/.well-known/oauth-protected-resource/mcp
Tools
15, all reads, no writes
Interactive views
MCP Apps views for usage, Microsoft 365 Copilot usage and billing
Organization scope
Membership checked on every tool call
Billing data
Organization admins only
Clients
ChatGPT, Claude website and desktop app, Microsoft 365 Copilot, Codex CLI, OpenCode, Claude Code, remote-capable MCP clients

Remote-first, every tool read-only

The hosted server works with browser-based and remote-capable agents over HTTP. Its 15 read-only tools discover organizations and return usage summaries, usage by model, provider or connection, Microsoft 365 Copilot, coding agent and browser extension usage, projects, connections, billing periods, invoices, footprint statements, carbon receipts, Trust badge links, plan tiers and setup guidance. None writes, deletes or changes billing.

  • Interactive answers in the chat

    In chat apps that support MCP Apps, such as Microsoft 365 Copilot and Claude, usage, Microsoft 365 Copilot and billing answers open as an interactive view: tiles and charts with a period switch, tabs for billing periods, invoices and the badge, a link to each footprint statement and a download for each signed carbon receipt. Other clients get the same data as text.

  • OAuth protects every read

    Your MCP client discovers the protected resource, opens the CrbonFree sign-in and receives a bearer token. The server validates that token on every request before any tool runs.

  • Organization checked on every call

    The token identifies the person, not an organization. Each tool call names the organization, and the server confirms the person is a member before it reads anything. Billing periods, invoices, statements and carbon receipts need an organization admin.

  • Local package remains available

    The npx package remains published for local-only clients. It is a deprecated fallback, not the recommended path, and remains available for teams that still need a local stdio server.

The same numbers as your dashboard

Every remote read comes from the same CrbonFree organization data the dashboard shows, checked against the person's membership on each call. Your agent can receive usage, connections, projects, billing periods, invoices, statements and receipts, and chat apps that support MCP Apps show them as tiles, charts and tables.

See the dashboard in the sample account

What it does not do

Everything it does is a read. None of the 15 tools writes, deletes or changes a plan. Statements, carbon receipts and Trust badge links need a paid plan, and billing periods, invoices, statements and carbon receipts need an organization admin. The remote endpoint requires OAuth 2.1 through an MCP client, and every read is limited to organizations the person belongs to.

How the MCP server moves your data

  1. 1

    You ask in plain language

    A question about usage, a project, a connection, an invoice, a receipt or a statement goes to your agent as it normally would.

  2. 2

    The agent picks a tool

    It selects one of 15 read-only tools for usage, carbon, billing periods, invoices, statements, receipts, connections, projects, the Trust badge, plan tiers or setup guidance.

  3. 3

    OAuth authorizes the remote server

    The MCP client sends its OAuth bearer token to the hosted endpoint, which validates it and checks that the person belongs to the organization named in the call.

  4. 4

    The agent answers with the numbers

    The server returns the organization's data. The agent phrases the answer, and chat apps that support MCP Apps also show it as an interactive view.

How to get started

In ChatGPT or Claude, no code

No code and nothing to install. Add CrbonFree to the chat app you already use, sign in once, and ask about your footprint in plain English.

ChatGPT

  1. 1In ChatGPT, open Settings and turn on Developer mode.
  2. 2Open Plugins from the sidebar, select Add, then Create MCP App.
  3. 3Name it CrbonFree, paste https://api.crbonfree.com/mcp under Connection, keep OAuth, tick the confirmation box and select Create.
  4. 4Select Continue to crbonfree, sign in with your CrbonFree email and the code we send you, then select Allow. CrbonFree is connected.

Developer mode depends on your ChatGPT plan. On Business and Enterprise, a workspace admin may need to allow it first.

Claude

  1. 1On claude.ai or the Claude desktop app, open your profile menu, then Settings, then Connectors.
  2. 2Select Add, then Add custom connector. Name it CrbonFree, paste https://api.crbonfree.com/mcp as the URL and select Continue.
  3. 3Select Connect on CrbonFree, then sign in with your CrbonFree email and the code we send you.
  4. 4Select Allow. CrbonFree is connected and ready in any new chat.

Works on every Claude plan. On Team and Enterprise, an owner adds the connector once in the organization settings.

In a coding agent

  1. 1

    Add the remote server

    Add https://api.crbonfree.com/mcp with the command for the coding agent you use.

    codex mcp add crbonfree --url https://api.crbonfree.com/mcp
    Codex CLI
    claude mcp add --transport http crbonfree https://api.crbonfree.com/mcp
    Claude Code
    opencode mcp add crbonfree --url https://api.crbonfree.com/mcp
    OpenCode
  2. 2

    Sign in

    Run the matching command to sign in to your CrbonFree account.

    codex mcp login crbonfree
    Codex CLI
    claude mcp login crbonfree
    Claude Code
    opencode mcp auth crbonfree
    OpenCode
  3. 3

    Ask a question

    Ask your agent to discover organizations, summarize usage or split it by model and provider, check Microsoft 365 Copilot or coding agent usage, look up a billing period or invoice, retrieve a statement or receipt, open a Trust badge link, compare plan tiers or get connection setup guidance. The remote server calls the matching read-only tool.

Questions to ask once you connect

Copy one into ChatGPT, Claude or your coding agent. Each question is answered by a read-only tool, so the reply uses the same numbers as your dashboard.

Sustainability officer

“What was our AI carbon footprint last month, broken down by provider and model?”

get_usage_breakdown
Sustainability officer

“Show our AI usage and emissions over the last 90 days.”

get_usage_summary
Sustainability officer

“Find our latest credit retirement receipt so I can cite it in the board update.”

get_receiptsPaid plans
Sustainability officer

“Give me the link to our verified sustainability badge and certificate.”

get_trust_assetsPaid plans
Finance

“Summarize our current billing period: tokens used, emissions and status.”

get_billing_periods
Finance

“How much did we pay for September, and where is the invoice?”

get_invoices
Finance

“Pull our most recent footprint statement for the quarterly report.”

get_statementsPaid plans
Operations

“How much do we use Microsoft 365 Copilot, and which apps use it most?”

get_m365_copilot_usage
Operations

“How many tokens did our coding agents use this week?”

get_coding_agent_usage
Operations

“Which of our AI providers are connected, and does any connection need attention?”

get_connections
Operations

“List our projects and tell me which one used the most tokens.”

get_projects
Getting started

“How do I connect our AWS Bedrock account to CrbonFree?”

get_connection_setup_guide
Getting started

“Compare the CrbonFree plans. Which one includes receipts?”

list_plan_tiers

Who reaches for the MCP server

Developer in an editor

Wants to list organization projects without leaving a remote-capable coding agent.

What they get: One question runs get_projects and returns only projects in the selected organization.

Sustainability officer

Needs a carbon receipt while preparing a board update.

What they get: get_receipts returns the organization's signed carbon receipts for an admin on a paid plan, and the billing view offers each receipt as a PDF download.

Finance lead

Needs what was paid for a billing period.

What they get: get_invoices returns the organization's invoices, each matched to the billing period it billed, with links to the invoice page and PDF.

IT admin

Wants to see how much the organization uses Microsoft 365 Copilot.

What they get: get_m365_copilot_usage returns prompts, estimated tokens and CO2e by Microsoft 365 app, with an organization view for admins.

New team member

Wants to compare plan tiers or get set up before connecting a provider.

What they get: list_plan_tiers or get_connection_setup_guide returns the plan comparison or the right setup link, without leaving the coding agent.

Which CrbonFree surface do I need?

Three of them put usage in: the dashboard through provider connections, the CLI for coding agents and the browser extension for chat sessions. The other four read the numbers back into your own code. The MCP server is highlighted.

SurfaceMeters usageReads numbers backRunsNeedsLanguage
DashboardIn the browserAn account; the sample account opens without oneNone
CLI statusOn your machineAn account; device code for headless machinesNode 20 or newer
Browser extension estimatesIn ChromeOptional, per the store listingNone
TypeScript SDKNode 18 or newerAn API keyTypeScript or JavaScript
Python SDKPython 3.8 or newerAn API keyPython
MCP serverthis pageRemote MCP endpointA CrbonFree accountAny MCP client
REST APIOver HTTPSAn API keyAny

Questions

Questions about the MCP server.

Short answers. The package page and the API reference have the long ones.

Open the dashboard

  • The remote server reads the data available to your CrbonFree organization. Usage and carbon estimates are available on the free plan, while receipts and audit packs depend on the plan.

  • Yes. The recommended endpoint is https://api.crbonfree.com/mcp. It uses remote HTTP MCP and OAuth 2.1, so remote-capable agents can connect without running a local package.

  • ChatGPT and Claude on the web or desktop connect as a custom connector with no code, and Microsoft 365 Copilot connects through the CrbonFree Microsoft 365 app. Codex CLI, OpenCode and Claude Code connect with one command each. Any MCP client that supports a remote HTTP server and OAuth 2.1 can use the same endpoint.

  • In chat apps that support MCP Apps, usage answers show tiles and a trend chart with a period switch, Microsoft 365 Copilot answers show prompts by app, and billing answers show billing periods, invoices and the badge in tabs, with a link to each footprint statement and a download for each signed carbon receipt. Clients without MCP Apps get the same data as text.

  • No. All 15 tools are reads. There are no mutations, no deletions and no billing changes, so an agent holding this server can look at your numbers but cannot alter them.

  • Your MCP client manages the OAuth token after you sign in. The remote server validates that token on every request and checks your membership in the organization each tool call names before it reads anything.

Goes well with

All products
DashboardEvery provider, project and coding agent in one report. The sample account opens without a login.CLIMeter your local AI coding agents automatically, synced to the dashboard every hour.Browser extensionEstimates token usage in your AI chat sessions across ChatGPT, Gemini and the Claude apps, including Claude Code. Guest mode keeps everything on your machine, and signing in keeps the history.

See your own number instead of ours.

However your team already runs AI, that is how you connect. Paste a read-only provider key, drop in an SDK, add the MCP server, install the CLI or switch on the browser extension, and the first measured tokens reach your dashboard within seconds.

Create your free account

Free plan · first tokens in seconds