By clicking “Accept”, you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. View our Privacy Policy for more information.

EarnDLT · MCP Connector

Manage your energy tokens from your AI assistant

Connect your AI assistant to the EarnDLT marketplace to review your token holdings and buy verified natural gas, RNG, and solid-fuel tokens — using plain requests instead of clicking through the app.

Works with any assistant that supports MCP connectors — including Claude and ChatGPT.

Key terms

A few concepts the connector uses throughout.

Profile	The organizational identity you act under. Your account may have access to several profiles (different legal entities or business units). Every wallet, cart, and order belongs to exactly one profile, so most actions start by picking which profile you mean.
Wallet	The token account attached to a profile (normally one per profile). Holds your balances.
QET	Quantified Emission Token — the token you hold or buy. Each represents an Environmental Attribute Certificate for a measured quantity of fuel, with a known source and carbon intensity.
Cohort	A batch of QETs sharing the same attributes (source, vintage, location, serial-number range). Holdings are grouped into cohorts; marketplace listings are cohorts too.
Spot vs. forward	Spot is for tokens available now; forward is a commitment to take delivery later. Forwards can carry a pay-on-delivery amount on top of anything paid now.
Checkout / contract	Checkout freezes a cart into a firm order and assigns a contract number. After that, the cart can't be edited.

Prerequisites

An EarnDLT account with access to at least one profile.
An AI assistant that supports MCP connectors (for example Claude or ChatGPT) — typically on a paid plan.
To place orders: two-factor authentication (TFA) enabled on your EarnDLT account.

Connect

Two ways to add the connector.

From your assistant's directory

Where the operator lists it (availability varies).

Open your assistant's connector settings.
Find EarnDLT and add it.
Sign in via the EarnDLT OAuth prompt to grant read / write access.

As a custom connector (by URL)

In your assistant's connector settings, choose add a custom connector.
URL: https://heritage.prod.earndlt.com/mcp
Sign in via the EarnDLT OAuth prompt.

Placing orders needs a TFA-enabled connection. Enable TFA on your EarnDLT account, then reconnect if needed.

Authentication

OAuth 2.0 with scopes read and write. Bearer token via header. Your access is limited to the profiles your EarnDLT account is authorized for.

What you can do

The connector exposes 18 tools, grouped by what they're for.

Review holdings

whoamiWho you're connected as, and your access.

list_profilesThe profiles available to you.

list_walletsYour wallets.

get_wallet_summaryOverall balances for a wallet.

list_cohortsYour token batches (holdings).

get_cohortFull detail on one holding, including serial-number ranges.

list_pending_incoming_cohortsTokens you've bought that haven't been delivered yet (e.g. forwards awaiting payment).

list_business_locationsYour delivery locations.

Shop the marketplace

search_marketplaceFind listings by fuel type, vintage, location, or carbon intensity.

get_marketplace_cohortFull detail on one listing before you buy.

Buy · write actions

get_purchase_cartView or start your draft cart.

add_to_purchase_cartAdd a cart line, choosing a delivery location.

remove_from_purchase_cartRemove a cart line.

checkout_purchase_cartFreeze the order and get a contract number.

confirm_purchasePlace the order and issue an invoice.IrreversibleRequires TFA

reject_purchase_orderReject a checked-out order (terminal).

Track

list_purchase_ordersYour order history.

get_purchase_orderCurrent status of one order.

How a purchase flows

1Search the marketplace

Find a listing that matches what you need.

2Add to cart

Add the listing, choosing a delivery location.

3Review cost

See the amount due now, plus any pay-on-delivery amount for forwards.

4Checkout

Freezes the order and assigns a contract number.

5Confirm

Places the order and issues an invoice.

Payment settles off-platform and tokens deliver afterward. The connector marks checkout and confirm as actions that need your approval, so your assistant prompts you before running them.

Example prompts

Who am I connected as, and which profiles can I use?

Show my wallet balance and list my token holdings for [profile].

Do I have any purchases that haven't been delivered yet?

Search the marketplace for RNG tokens delivered near [location] with the lowest carbon intensity.

Give me the full details on that listing before I buy.

Add 1,000 units of that listing to my cart with [location] as the delivery point.

What's my cart total, including any pay-on-delivery amounts?

Check out the cart, then place the order.