Connect
Cover: Use BlazePhoenix from AI agents: Claude Code, Gemini CLI and any MCP client

Use BlazePhoenix from AI agents: Claude Code, Gemini CLI and any MCP client

Give an AI agent on-chain DEX quotes it can verify: install BlazePhoenix as a Claude Code plugin, a Gemini CLI extension or an MCP server, hosted or local. One command each.

BlazePhoenix Engineering · article updated 2026-10-05 · site dataset through 2026-11-19 · 5 min · written from the deployed bytecode

At a glance
LevelAdvanced
Reading time5 min
Sections6
Updated2026-10-05

By Mitra (@Sigmacrit) — anonymous developer of the BlazePhoenix protocol. The code is the résumé.

Abstract in 15 languages · resumo · resumen · 摘要 · 要旨 · ملخص

English — How to give an AI agent BlazePhoenix quotes with one command: as a Claude Code plugin, a Gemini CLI extension or an MCP server, hosted with no key or RPC call, or local against your own node. Which other clients can use it, and why the agent never holds keys or sends transactions.

Português — Como dar cotações da BlazePhoenix a um agente de IA com um único comando: como plugin do Claude Code, extensão do Gemini CLI ou servidor MCP, alojado sem chave nem chamada RPC, ou local contra o seu próprio nó. Que outros clientes o podem usar, e porque é que o agente nunca guarda chaves nem envia transacções.

Español — Cómo dar cotizaciones de BlazePhoenix a un agente de IA con un solo comando: como plugin de Claude Code, extensión de Gemini CLI o servidor MCP, alojado sin clave ni llamada RPC, o local contra tu propio nodo. Qué otros clientes pueden usarlo, y por qué el agente nunca guarda claves ni envía transacciones.

Français — Comment donner des cotations BlazePhoenix à un agent IA en une seule commande : comme plugin Claude Code, extension Gemini CLI ou serveur MCP, hébergé sans clé ni appel RPC, ou local sur votre propre nœud. Quels autres clients peuvent l'utiliser, et pourquoi l'agent ne détient jamais de clés et n'envoie jamais de transactions.

Deutsch — Wie man einem KI-Agenten BlazePhoenix-Quotes mit einem einzigen Befehl gibt: als Claude-Code-Plugin, Gemini-CLI-Erweiterung oder MCP-Server, gehostet ohne Schlüssel und ohne RPC-Aufruf oder lokal gegen den eigenen Node. Welche anderen Clients ihn nutzen können und warum der Agent nie Schlüssel hält oder Transaktionen sendet.

Русский — Как дать ИИ-агенту котировки BlazePhoenix одной командой: как плагин Claude Code, расширение Gemini CLI или MCP-сервер — размещённый, без ключа и без RPC-вызовов, или локальный, работающий с вашим узлом. Какие ещё клиенты могут его использовать и почему агент никогда не хранит ключи и не отправляет транзакции.

Türkçe — Bir yapay zekâ ajanına tek komutla BlazePhoenix kotasyonları vermek: Claude Code eklentisi, Gemini CLI uzantısı ya da MCP sunucusu olarak; anahtarsız ve RPC çağrısız barındırılan ya da kendi düğümünüze karşı yerel. Başka hangi istemcilerin kullanabileceği ve ajanın neden asla anahtar tutmadığı ya da işlem göndermediği.

العربية — كيف تمنح وكيل ذكاء اصطناعي تسعيرات BlazePhoenix بأمر واحد: كإضافة لـ Claude Code أو امتداد لـ Gemini CLI أو خادم MCP، مستضاف بلا مفتاح ولا استدعاء RPC، أو محلي يعمل على عقدتك الخاصة. ما العملاء الآخرون الذين يمكنهم استخدامه، ولماذا لا يحتفظ الوكيل أبدًا بمفاتيح ولا يرسل معاملات.

हिन्दी — एक ही कमांड से किसी AI एजेंट को BlazePhoenix कोट कैसे दें: Claude Code प्लगइन, Gemini CLI एक्सटेंशन या MCP सर्वर के रूप में — बिना की और बिना RPC कॉल के होस्टेड, या आपके अपने नोड पर लोकल। और कौन-से क्लाइंट इसे इस्तेमाल कर सकते हैं, और एजेंट कभी की क्यों नहीं रखता या ट्रांज़ैक्शन क्यों नहीं भेजता।

日本語 — コマンド一つで AI エージェントに BlazePhoenix の見積もりを与える方法:Claude Code プラグイン、Gemini CLI 拡張、または MCP サーバーとして — キーも RPC 呼び出しも不要なホスト型、あるいは自分のノードを使うローカル型。ほかにどのクライアントが使えるか、そしてエージェントが鍵を持たずトランザクションも送らない理由。

中文 — 如何用一条命令让 AI 代理获得 BlazePhoenix 报价:作为 Claude Code 插件、Gemini CLI 扩展或 MCP 服务器,可选无需密钥、不发 RPC 调用的托管版,或连接你自己节点的本地版。还有哪些客户端可以使用,以及为什么代理从不持有密钥或发送交易。

한국어 — 명령 하나로 AI 에이전트에게 BlazePhoenix 견적을 주는 방법: Claude Code 플러그인, Gemini CLI 확장, 또는 MCP 서버로 — 키도 RPC 호출도 없는 호스팅형, 혹은 자신의 노드에 연결하는 로컬형. 그 밖에 어떤 클라이언트가 사용할 수 있는지, 그리고 에이전트가 결코 키를 보관하거나 트랜잭션을 보내지 않는 이유.

Bahasa Indonesia — Cara memberi agen AI kuotasi BlazePhoenix dengan satu perintah: sebagai plugin Claude Code, ekstensi Gemini CLI, atau server MCP, baik di-hosting tanpa kunci maupun panggilan RPC, atau lokal terhadap node Anda sendiri. Klien lain mana yang bisa memakainya, dan mengapa agen tidak pernah memegang kunci atau mengirim transaksi.

বাংলা — একটি কমান্ডে কীভাবে একটি AI এজেন্টকে BlazePhoenix কোট দেবেন: Claude Code প্লাগইন, Gemini CLI এক্সটেনশন বা MCP সার্ভার হিসেবে — কী ও RPC কল ছাড়া হোস্টেড, অথবা নিজের নোডে লোকাল। আর কোন কোন ক্লায়েন্ট এটি ব্যবহার করতে পারে, এবং এজেন্ট কেন কখনো কী রাখে না বা লেনদেন পাঠায় না।

Filipino — Paano bigyan ang isang AI agent ng mga quote ng BlazePhoenix sa isang command: bilang Claude Code plugin, Gemini CLI extension o MCP server, naka-host nang walang key o RPC call, o lokal laban sa sarili mong node. Aling iba pang client ang maaaring gumamit nito, at bakit hindi kailanman humahawak ng key o nagpapadala ng transaksyon ang agent.

BlazePhoenix is available to AI agents as an MCP server, a Claude Code plugin and a Gemini CLI extension. Each install is 1 command. The hosted server needs no key and makes no RPC call; the local server reads the chain through your own node and adds one-step quotes and swaps.

How do you add it to Claude Code?

Two routes: the plugin, which bundles the hosted server and a skill, or the MCP server directly.

# plugin (hosted MCP + the blazephoenix-defi skill)
claude plugin marketplace add blazephoenixxyz-crypto/blazephoenix-mcp
claude plugin install blazephoenix@blazephoenix

# or the hosted MCP server alone
claude mcp add --transport http blazephoenix https://blazephoenix.xyz/mcp

How do you add it to Gemini CLI?

The extension is published from the same public repository, which carries a gemini-extension.json and a GEMINI.md telling the model how to use the tools.

gemini extensions install https://github.com/blazephoenixxyz-crypto/blazephoenix-mcp

When should you run the local server instead?

The hosted server prepares and decodes, and leaves the chain read to the agent. When you want the server to do the read — quotes, swaps and solvency checks in one tool call — run it locally against your own RPC. Your node, your rate limits, no third party in the path.

claude mcp add blazephoenix -e BLAZEPHOENIX_RPC_BASE=<your Base node URL> -- npx -y @blazephoenix/mcp

Which other clients can use it?

Any client that speaks the Model Context Protocol over streamable HTTP can point at https://blazephoenix.xyz/mcp. The server is listed in the official MCP registry as xyz.blazephoenix/mcp, which is where registry-aware clients and directories find it. Agents that read the web rather than call tools can start from /llms.txt, the skill file at /skills/blazephoenix/SKILL.md, and the OpenAPI document at /api/openapi.json.

What will the agent never do?

BlazePhoenix's agent tools are read-only by design.

Hold keys or send transactions for the user. Every tool is read-only; quotes come back with unsigned calldata that the user signs in their own wallet, and the BlazePhoenix Router enforces the minimum output on-chain whatever the agent does. That separation is what makes it safe to give an agent the tools at all.

Do not trust this page — reproduce it

Every claim above is checkable against the chain. Start here:

curl -s -X POST https://blazephoenix.xyz/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Cite this article

Licensed CC BY-NC-ND 4.0: quote and cite it with attribution and a link. Commercial use and derivative versions need written permission from BlazePhoenix; translations are made by BlazePhoenix. Copy a ready-made citation:

BlazePhoenix (2026). Use BlazePhoenix from AI agents: Claude Code, Gemini CLI and any MCP client. BlazePhoenix Engineering. https://blazephoenix.xyz/learn/use-blazephoenix-from-ai-agents/
@misc{blazephoenix_use_blazephoenix_from_ai_agents,
  title  = {Use BlazePhoenix from AI agents: Claude Code, Gemini CLI and any MCP client},
  author = {BlazePhoenix},
  year   = {2026},
  url    = {https://blazephoenix.xyz/learn/use-blazephoenix-from-ai-agents/},
  note   = {Accessed: reproduce the claim with the command above}
}

Writing an answer, a wiki entry or a paper? The claim above is reproducible against the chain before you quote it — which is the only sound basis for citing a technical source at all.

Contracts are verified on every chain we deploy to — addresses in the protocol manifest. Deeper formal treatment: the whitepaper (PDF).

Related engineering

Next in Architecture · 16 / 20
The attack surface, counted: 23 calldata fields, nothing held at rest, and two numbers about how the tests look ›Every field an integrator can write into calldata is classified in fields.json — 23 rows: 5 steering, 14 confirmed against an observation, 4 declared with the reason recorded. The Router holds nothing between transactions.7 min

Questions, a partnership or a bug to report? Contact us or email contact@blazephoenix.xyz

Go to APP