mapleai-mcp

MapleAI — x402 の従量課金による GPT、Claude、エージェント API

OpenAI 互換の GPT と Anthropic ネイティブの Claude チャット、複数ステップのエージェント実行、画像、音声、X（Twitter）のインテリジェンス、埋め込み、構造化判断 API を、単一のエンドポイントで提供します。アカウントもサブスクリプションも不要です。従量課金プランでは API キーも不要で、エージェントは x402 プロトコルを通じて USDC で呼び出しごとに支払います。リクエストごとの支払いではなくトークン予算を希望するクライアント向けに、プリペイド API キーも利用できます。

稼働中のエンドポイント

ネットワーク	ベース URL	ファシリテーター
Solana	https://sol.mapleai.shop	Coinbase CDP
Base	https://base.mapleai.shop	Coinbase CDP
Polygon	https://polygon.mapleai.shop	Coinbase CDP
Arc	https://arc.mapleai.shop	local

プリペイドキーのエンドポイント（共通）：https://mapleai.shop/v1

モデルと料金

GPT（100万トークンあたり）

モデル	入力	出力
openai/gpt-5.6-sol	$2.80	$14.00
openai/gpt-5.6-terra	$1.40	$8.40
openai/gpt-6-luna	$0.07	$0.35
openai/gpt-6-sol	$1.40	$7.00

リクエスト料金は、カウントされた入力トークン数 × 入力単価 + 要求された出力トークン数 × 出力単価に、ネットワークの決済手数料（約 $0.001）を加えて算出します。正確な金額は常に 402 チャレンジに記載されます。失敗した呼び出し（HTTP ≥ 400）はキャンセルされ、決済されません。

Claude（100万トークンあたり）

ネイティブの Anthropic Messages API（POST /v1/messages）に対応しています（システムプロンプト、コンテンツブロック、SSE イベント、必須の max_tokens。システムプロンプトは入力トークンとして課金されます）。OpenAI 互換の /v1/chat/completions からも利用できます。

モデル	入力	出力
anthropic/claude-haiku-4-5	$0.50	$2.50
anthropic/claude-sonnet-4-5, anthropic/claude-sonnet-4-6	$1.50	$7.50
anthropic/claude-sonnet-5, anthropic/claude-sonnet-5-5	$1.00	$5.00
anthropic/claude-opus-4-6, anthropic/claude-opus-4-7, anthropic/claude-opus-4-8, anthropic/claude-opus-5	$2.50	$12.50
anthropic/claude-opus-5-5	$2.00	$10.00

エージェント実行

POST /v1/agents/execute — 複数ステップのエージェントループ（推論 → ツール呼び出し → 最終回答）。Cluster Protocol 互換のレスポンスに対応しています。"stream": true を指定すると、SSE でステップをストリーミングできます（ツールの実行中は step イベント、最終結果では done）。組み込みツール：決定論的な calculator、最大 500 個の数値を対象とする統計分析の data_analysis、キー不要の web_search（Exa）、および fetch_url。ステップごとのタイムアウト時は、単なる 502 ではなく部分的な結果を返します。

エンジン	基本料金	ステップごと	上流モデル
agents/oss-20b	$0.002	$0.0005	gpt-oss-20b（低価格プラン）
agents/gpt-6-sol	$0.004	$0.004	gpt-6-sol（プレミアム）

上限額として課金されます。チャットの max_tokens と同様に、基本料金 + max_steps × ステップ単価（+ ツールごとの上限額）となり、1 タスクあたり最大 20 ステップです。

画像（1 枚あたり）

モデル	料金
gpt-image-2	$0.02
gpt-image-2.5, gpt-image-2.5-flare, gpt-image-2.5-sunburst	$0.04
grok-imagine-image	$0.045
gpt-image-2-2k	$0.09
gpt-image-2.5-sunburst-2k	$0.22

POST /api/v1/images/generations と POST /api/v1/images/image2image（PNG/JPEG/WebP のデータ URI を編集。最大 10 MB）。Solana では画像生成が Solana のブロックハッシュの有効期間を超えるため、これらのルートは事前に決済し、同じ有料リクエスト内で一時的な上流エラーを再試行します。

オーディオ（リクエストごと）

モデル	エンドポイント	料金
tts-1、tts-1-hd（Gemini flash/lite）、orpheus-english、orpheus-arabic（Groq Orpheus）	POST /v1/audio/speech	$0.015
whisper-1（Gemini 3.5）、whisper-large-v3、whisper-large-v3-turbo（Groq）	POST /v1/audio/transcriptions	$0.006

TTS は JSON {model, input, voice?, response_format?} を受け取り、WAV ストリームを返します。OpenAI の音声プリセットは Gemini の音声に対応し、orpheus モデルは 独自の感情豊かな音声を使用します（en：autumn/diana/hannah/austin/daniel/troy、ar： fahad/sultan/noura/lulwa/aisha/abdullah、[laughs]形式のタグと実際の speed に対応）。STT は multipart の file と model、または JSON の base64 を受け取り、上限は 25 MB です。whisper-large-v3* は verbose_json の単語単位のタイムスタンプと srt／vtt に対応します。レスポンスには x-audio-upstream と x-fallback-used ヘッダーが含まれます。プライマリベンダーで障害が発生すると、同じ支払い内でリクエストがセカンダリベンダーにフェイルオーバーします（TTS ではその場合、音声が異なります）。

X（Twitter）のインテリジェンス

Grok の x_search によるリアルタイムの X 検索と分析：

エンドポイント	機能	料金の計算式
POST /v1/x/search	投稿の引用付きで要約した回答を返します	$0.015 + $0.0015 × max_results（include_web を指定すると+$0.01）
POST /v1/x/digest	指定したハンドルの一定期間をさかのぼったダイジェスト	$0.02 + $0.005 × ハンドル数
POST /v1/x/sentiment	感情の判定、スコア、分布、要因を返します	$0.025 + $0.0015 × 根拠となる投稿数 + $0.005 × 日数
POST /v1/x/factcheck	主張について、賛否の根拠とともに判定を返します	$0.03 + $0.002 × ソース数
POST /v1/x/profile	プロフィールの詳細：自己紹介、フォロワー、トピック、フラグ	$0.02 + $0.015 × ハンドル数
POST /v1/x/media	投稿メディアの画像／動画を理解します	$0.02 + $0.002 × 結果数

Jev の構造化された意思決定

POST /jev — jev-latest、入力トークン 100 万件あたり $0.06、出力は無料。SystemOne プロトコルでは、model、state、名前付きの questions（instructions を指定した noul、choice、または score）を送信し、レスポンスから answers を読み取ります。

無料プラン

POST /v1/embeddings — 無料の NVIDIA nvidia/nemotron-3-embed-1b（2048 次元）。input は文字列、または最大 128 個の文字列を含む配列で指定します。 model は任意で、指定しても無視されます。

POST /v1/free/chat/completions — 無料の nvidia/gpt-oss-20b チャット。 エージェントごとにレート制限があります（10 分あたり 10 リクエスト、1 日あたり 100 リクエスト）。

クイックスタート

# 1. Any request without payment returns HTTP 402 with the exact quote
curl -i https://base.mapleai.shop/v1/chat/completions \
  -H 'content-type: application/json' \
  -d '{"model":"openai/gpt-6-luna","messages":[{"role":"user","content":"Hello"}],"max_tokens":64}'

# 2. An x402-aware client signs the challenge and retries automatically

import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });

const first = await fetch(url, { method: "POST", headers, body });
const challenge = JSON.parse(Buffer.from(first.headers.get("payment-required"), "base64").toString());
const payment = await client.createPaymentPayload(challenge);
const paid = await fetch(url, {
  method: "POST",
  headers: { ...headers, "payment-signature": Buffer.from(JSON.stringify(payment)).toString("base64") },
  body,
});

実行可能なエンドツーエンドのデモ（無料のエンベディング → 有料の GPT 回答）は examples/embeddings-to-chat/ にあり、オンラインでは https://base.mapleai.shop/examples/embeddings-to-chat/ で利用できます。

エージェントを構築していますか？agent-starter/ テンプレートをフォークしてください。 エージェントクライアント向けのリポジトリ手順（CLAUDE.md／AGENTS.md）、MCP の接続設定、 完全な有料シナリオスクリプト（無料のエンベディング → プリペイド tap → プリペイド chat）、 および 4 つすべてのゲートウェイを対象とする無料の CI スモークテストが含まれています。

プリペイド API キー

1 回の x402 支払いで、1 つの GPT または Claude モデル用のプリペイド bearer キー、あるいは Jev 入力パックを購入できます。

curl https://base.mapleai.shop/prepaid/codes \
  -H 'content-type: application/json' \
  -d '{"model":"openai/gpt-6-luna","tokens":100000}'

予算は 100 000 トークンから 1 000 000 トークンまで、100 000 トークン単位で設定できます。料金は モデルの入力レートに決済手数料を加算した金額です。

モデル	0.1M パック	1M パック
openai/gpt-5.6-sol	$0.28	$2.80
openai/gpt-5.6-terra	$0.14	$1.40
openai/gpt-6-luna	$0.007	$0.07
openai/gpt-6-sol	$0.14	$1.40
anthropic/claude-haiku-4-5	$0.05	$0.50
anthropic/claude-sonnet-5	$0.10	$1.00
anthropic/claude-opus-5	$0.25	$2.50
jev-latest（入力トークンのみ、出力は無料）	$0.006	$0.06

GPT および Claude のキーは POST /prepaid/v1/chat/completions で使用します（サブドメインおよび、OpenAI 互換の共有エンドポイント https://mapleai.shop/v1 で利用できます）。 Jev パックは POST /prepaid/v1/jev で使用します。使用量とステータスは無料で確認できます。

curl https://mapleai.shop/v1/prepaid/status \
  -H "Authorization: Bearer oms_buy_..."

サービスの確認

• GET /v1/models — ライブ価格情報付きの無料モデルカタログ
• GET /.well-known/x402 — x402 リソースマニフェスト
• GET /openapi.json — OpenAPI 3.1 仕様
• GET /llms.txt、GET /AI-AGENTS.md — エージェント向けドキュメント
• GET /developers — サンプル付きの開発者ガイド

リポジトリ構成

• src/ — x402 ゲートウェイ（Express、TypeScript、tsx で実行）
• admin/ — OmniRoute ベースの管理アプリ：プロバイダー接続、コンボ、 プリペイドキーの発行、ウォレットのみ（SIWE）のダッシュボード
• examples/ — 実行可能なクライアントのサンプル
• packages/mapleai-mcp/ — ローカルの stdio MCP サーバー（無料モデルカタログ、埋め込み、プリペイドステータス、有料の GPT および Claude チャット、Jev、エージェント実行、ローカル x402 署名を使ったプリペイドキーパックを提供。購入済みキーはウォレットなしで、サーバー内の prepaid_chat を通じて利用できます）
• tools/ — 決済および上流サービスのテストスクリプト
• deploy/ — VDS で使用する systemd ユニットと Apache 仮想ホスト

開発

npm install
cp .env.example .env   # fill in UPSTREAM_API_KEY, PAY_TO, model prices
npm run typecheck
npm start              # listens on PORT (default 4021)

必須の環境変数：UPSTREAM_API_KEY、PAY_TO、MODEL_PRICES、MODEL_MAPPING。 オプション機能は、それぞれのキーで有効になります（IMAGE_UPSTREAM_API_KEY、 NVIDIA_API_KEY、JEV_UPSTREAM_API_KEY、PREPAID_ISSUER_TOKEN など）。全リストは .env.example を参照してください。