CarbonMeld MCPサーバー
プレミアムAPIキーでMCPクライアントを接続:プロジェクト検索、完全な記録、オファーチェック、CORSIA供給、バイヤープロフィール。
できること
Model Context Protocol(MCP)を通じて、アシスタントがCarbonMeldのプロジェクト記録とレジストリ情報を参照できます。MCP処理では言語モデルを動かしません。返されたデータはお使いのアシスタントが解釈します。CarbonMeldの記録を読み取り、クレジットの発行・購入・移転は行いません。
5つのツール
search_projects
入力: query、registry、min_score、claim、limit(1~25、既定値10)
プロジェクト名の語句や登録コードで検索し、基準、スコア、主張タグで絞り込みます。識別子、国、評価、登録状況、主張タグ、プロジェクトURLを返します。
get_project
入力: id(必須)
スラッグまたは登録コードで取得できる全記録。分析、リスク情報、ビンテージ、主張を含みます。プレミアムの詳細は共通のプロジェクト枠を使用します。
check_offer
入力: text(必須)、vintage・quantity・seller(任意)
貼り付けたオファーを登録、ビンテージ、数量、主張、開発者の記録と照合します。特定のシリアル番号の所有権や利用可能性は確認しません。
corsia_supply
入力: なし
レジストリのラベルに基づく、レジストリ別・フェーズ別のCORSIA供給とFirst Phaseの高評価プロジェクト。
get_buyer
入力: name(必須、会社名またはバイヤースラッグ)
組織の公開償却記録:トン数、プロジェクトとその品質。償却の受益者が購入者とは限りません。名前が曖昧な場合は確認が必要です。
search_projectsのclaim指定値:corsia、corsia_first、ccp、ccp_meth、removal、article6。ラベルはCarbonMeldが保有する記録を反映します。
クライアントを接続する
リモートサーバーURLと固定のAuthorizationヘッダーを設定できるMCPクライアントを使用してください。設定画面はクライアントごとに異なります。このガイドは特定アプリとの互換性を保証するものではありません。
- 有効なパスでアカウント欄からキーを発行します。
- 以下のリモートサーバーURLを設定し、自分のキーを含むAuthorizationヘッダーを追加します。
- 接続してツール一覧を取得し、まずプロジェクトを検索してから完全な記録を開くようアシスタントに依頼します。
接続設定
https://carbonmeld.com/api/v1/mcp
Authorization: Bearer cmk_YOUR_KEY_HERE 通信方式はHTTP POSTによるJSON-RPC 2.0で、JSONを返します。サーバーURLをGETで開くと405になります。Webページではありません。
プロトコルバージョン: 2025-06-18
例:ツールを一覧表示
curl 'https://carbonmeld.com/api/v1/mcp' \
-H 'Authorization: Bearer cmk_YOUR_KEY_HERE' \
-H 'Content-Type: application/json' \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' 上限とフェアユース
- 300 リクエスト/日/キーが標準上限です。RESTとMCPで共有します。
- 30 件の異なるプレミアムプロジェクト/日を、サイト、PDFレポート、REST、MCPで共有します。同日に同じプロジェクトを再表示しても1件です。ポートフォリオ内および個別にアンロックされたプロジェクトは対象外です。公開記録のみの取得もこの枠を使いません。
- 20 回のオファーチェック/日/アカウント。サイトのオファーチェックと共有します。
日次カウンターは00:00 UTCにリセットされます。IPごとに毎分120リクエストのバースト上限もあります。一覧と統計の取得はリクエスト上限に含まれますが、プレミアムプロジェクト枠は使いません。
get_projectはREST APIと同じプレミアムプロジェクト枠を使います。MCPの接続・ツールリクエストもAPIのリクエスト上限に含まれます。
認証や頻度のエラーはHTTPステータスで返ります。HTTPが成功しても、ツール結果にisError: trueが含まれる場合があります。結果を確認してください。一時的なデータエラーは否定的な判定ではありません。後で再試行してください。
データとプライバシー
クライアントは貼り付けたオファー文などのツール引数をCarbonMeldに送信します。返された記録はクライアントに渡り、お使いのアシスタントが推論します。必要な情報だけを共有し、クライアントのデータ設定を確認してください。CarbonMeldはパス機能の利用とプレミアムプロジェクトへのアクセスを記録します。
REST APIと同じキー
HTTPの直接リクエスト、一覧パラメーター、エラーコードはRESTガイドをご覧ください。
APIガイド