Repository avatar
AI Tools
v0.3.1
active

mapleai-mcp

io.github.veenrek/mapleai-mcp

Pay-per-request GPT chat, embeddings, agents and prepaid keys with local x402 USDC signing

Documentation

MapleAI — GPT, Claude and Agent APIs with x402 Pay-Per-Request

OpenAI-compatible GPT and Anthropic-native Claude chat, multi-step agent execution, image, audio, X (Twitter) intel, embeddings and structured-decision APIs behind one endpoint. No accounts, no subscriptions, no API keys for the pay-per-request tier — an agent pays per call in USDC over the x402 protocol. Prepaid API keys are available for clients that prefer a token budget over per-request payments.

Live endpoints

NetworkBase URLFacilitator
Solanahttps://sol.mapleai.shopCoinbase CDP
Basehttps://base.mapleai.shopCoinbase CDP
Polygonhttps://polygon.mapleai.shopCoinbase CDP
Archttps://arc.mapleai.shoplocal

Prepaid key endpoint (shared): https://mapleai.shop/v1

Models and pricing

GPT (per 1M tokens)

ModelInputOutput
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

A request is quoted as counted input tokens × input rate + requested output tokens × output rate, plus the network settlement fee (about $0.001; the exact amount is always in the 402 challenge). Failed calls (HTTP ≥ 400) are cancelled, not settled.

Claude (per 1M tokens)

Native Anthropic Messages API at POST /v1/messages (system prompt, content blocks, SSE events, required max_tokens; the system prompt is billed as input tokens). Also reachable via the OpenAI-compatible /v1/chat/completions.

ModelInputOutput
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

Agent execution

POST /v1/agents/execute — multi-step agent loop (reason → call tools → final answer), Cluster Protocol-compatible response. Optional SSE step streaming with "stream": true (step events as tools run, done with the final result). Built-in tools: deterministic calculator, data_analysis (statistics over up to 500 numbers), keyless web_search (Exa) and fetch_url. Per-step timeout returns partial results instead of a bare 502.

EngineBasePer stepUpstream model
agents/oss-20b$0.002$0.0005gpt-oss-20b (cheap tier)
agents/gpt-6-sol$0.004$0.004gpt-6-sol (premium)

Charged as a ceiling — base + max_steps × per-step price (+ tool ceilings), like max_tokens for chat; up to 20 steps per task.

Images (per image)

ModelPrice
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 and POST /api/v1/images/image2image (edit a PNG/JPEG/WebP data URI, max 10 MB). On Solana these routes settle upfront (image generation outlives a Solana blockhash) and retry transient upstream failures inside the same paid request.

Audio (per request)

ModelEndpointPrice
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 takes JSON {model, input, voice?, response_format?} and returns a WAV stream; OpenAI voice presets map to Gemini voices, the orpheus models use their own emotive voices (en: autumn/diana/hannah/austin/daniel/troy, ar: fahad/sultan/noura/lulwa/aisha/abdullah; [laughs]-style tags and real speed supported). STT takes multipart file + model or JSON base64, up to 25 MB; whisper-large-v3* add verbose_json word timestamps and srt/vtt. Responses carry x-audio-upstream and x-fallback-used headers — when the primary vendor fails the request fails over to a secondary one inside the same payment (for TTS the voice differs then).

X (Twitter) intel

Live X search and analytics via Grok x_search:

EndpointWhat it doesPrice formula
POST /v1/x/searchsummarized answer with post citations$0.015 + $0.0015 × max_results (+$0.01 with include_web)
POST /v1/x/digestdigest of specific handles over a look-back window$0.02 + $0.005 × handles
POST /v1/x/sentimentsentiment verdict, score, distribution, drivers$0.025 + $0.0015 × evidence posts + $0.005 × days
POST /v1/x/factcheckclaim verdict with evidence for/against$0.03 + $0.002 × sources
POST /v1/x/profileprofile dossier: bio, followers, topics, flags$0.02 + $0.015 × handles
POST /v1/x/mediaimage/video understanding over post media$0.02 + $0.002 × results

Jev structured decisions

POST /jev — jev-latest, $0.06 per 1M input tokens, output free. SystemOne protocol: send model, state and named questions (noul, choice or score with instructions), read answers from the response.

Free tier

POST /v1/embeddings — free NVIDIA nvidia/nemotron-3-embed-1b (2048 dimensions). Send input as a string or an array of up to 128 strings; model is optional and ignored.

POST /v1/free/chat/completions — free nvidia/gpt-oss-20b chat, rate-limited per agent (10 requests / 10 min and 100 / day).

Quickstart

# 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,
});

A runnable end-to-end demo (free embeddings → paid GPT answer) lives in examples/embeddings-to-chat/ and online at https://base.mapleai.shop/examples/embeddings-to-chat/.

Building an agent? Fork the agent-starter/ template — repo instructions for agent clients (CLAUDE.md/AGENTS.md), MCP wiring, a full paid scenario script (free embeddings → prepaid tap → prepaid chat), and a free CI smoke for all four gateways.

Prepaid API keys

Buy a prepaid bearer key for one GPT or Claude model, or a Jev input pack, with a single x402 payment:

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

Budgets run in 100 000-token steps from 100 000 to 1 000 000, priced at the model input rate plus the settlement fee:

Model0.1M pack1M pack
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 (input tokens only, output free)$0.006$0.06

GPT and Claude keys spend at POST /prepaid/v1/chat/completions (works on the subdomains and at the shared https://mapleai.shop/v1, OpenAI-compatible); Jev packs spend at POST /prepaid/v1/jev. Check usage and status for free:

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

Discovery

  • GET /v1/models — free model catalog with live pricing
  • GET /.well-known/x402 — x402 resource manifest
  • GET /openapi.json — OpenAPI 3.1 specification
  • GET /llms.txt, GET /AI-AGENTS.md — agent-oriented docs
  • GET /developers — developer guide with examples

Repository layout

  • src/ — the x402 gateway (Express, TypeScript, runs under tsx)
  • admin/ — OmniRoute-based admin app: provider connections, combos, prepaid key issuance and wallet-only (SIWE) dashboard
  • examples/ — runnable client examples
  • packages/mapleai-mcp/ — local stdio MCP server (free model catalog, embeddings and prepaid status; paid GPT and Claude chat, Jev, agent execution and prepaid key packs with local x402 signing; bought keys spend in-server via prepaid_chat with no wallet)
  • tools/ — payment and upstream test scripts
  • deploy/ — systemd units and Apache vhosts used on the VDS

Development

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)

Required env: UPSTREAM_API_KEY, PAY_TO, MODEL_PRICES, MODEL_MAPPING. Optional features are enabled by their own keys (IMAGE_UPSTREAM_API_KEY, NVIDIA_API_KEY, JEV_UPSTREAM_API_KEY, PREPAID_ISSUER_TOKEN, …) — see .env.example for the full list.

NPM
mapleai-mcp
Install Command
npm install mapleai-mcp