跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt

Use this file to discover all available pages before exploring further.

OrbitFlare MCP 服务器将针对 Shredstream 优化的 Solana RPC、gRPC 流式传输、专属节点与验证者基础设施暴露为 AI 助手可直接调用的工具。每项能力对应独立工具，具备聚焦的输入模式：无内部动作路由器，无基于结果 ID 的分页套路。
将 MCP 服务器与 技能 搭配使用效果最佳。技能教智能体 OrbitFlare 如何工作；MCP 服务器让它无需离开对话即可实际调用 OrbitFlare。

​
安装

大多数主机使用相同 JSON 结构；仅文件位置不同： 
{
  "mcpServers": {
    "orbitflare": {
      "command": "npx",
      "args": ["@orbitflare/mcp@latest"],
      "env": {
        "ORBITFLARE_API_KEY": "your-license-key",
        "ORBITFLARE_NETWORK": "mainnet"
      }
    }
  }
}
主机配置文件位置
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json（macOS）· %APPDATA%\Claude\claude_desktop_config.json（Windows）
Claude Code运行 claude mcp add orbitflare -- npx @orbitflare/mcp@latest，或在项目根目录放置 .mcp.json
Cursor~/.cursor/mcp.json（全局）或 <project>/.cursor/mcp.json
Gemini CLI~/.gemini/settings.json（全局）或 <project>/.gemini/settings.json
Windsurf~/.codeium/windsurf/mcp_config.json
VS Code取决于扩展（Continue、Cline、GitHub Copilot 代理模式）
Codex CLI 在 ~/.codex/config.toml（或 <project>/.codex/config.toml）使用 TOML： 
[mcp_servers.orbitflare]
command = "npx"
args = ["@orbitflare/mcp@latest"]

​
获取许可证密钥

在 orbitflare.com 注册，从控制台 Licenses（许可证） 部分复制许可证密钥。免费方案提供 10 RPS，足以立即开始构建。 若不想将密钥写入主机配置，可不设置该环境变量，并在对话中调用 setApiKey：
将我的 OrbitFlare API 密钥设为 xxxx-xxxx-xxxx。

​
配置

环境变量用途
ORBITFLARE_API_KEYRPC 许可证密钥（作为 JSON-RPC 的 ?api_key=）
ORBITFLARE_LICENSE_KEYORBITFLARE_API_KEY 的别名
ORBITFLARE_CUSTOMER_API_KEY客户 API v2 密钥（X-ORBIT-KEY 标头）。未设置时回退到 ORBITFLARE_API_KEY
ORBITFLARE_NETWORKmainnet（默认）或 devnet
ORBITFLARE_RPC_URL可选显式 RPC 端点 URL（覆盖区域/网络）。适用于专属节点。
ORBITFLARE_BEARER_TOKEN客户 API 的 Bearer 令牌。由 pollDeviceToken / verifyWalletSignature 自动填充，并持久化到 ~/.orbitflare/mcp-session.json。
所有值均可在运行时通过 setApiKey 工具覆盖，便于切换网络或固定区域而无需重启主机。

​
区域端点

默认使用 mainnet（自动路由）。要固定区域，请通过 setApiKey 使用以下之一：ash、ny、la、slc、ams、fra、lon、dub、siau、tok、sgp。

​
工具

共 53 个工具，按领域分组。每个工具可独立调用。

​
RPC 读取

工具作用
getBalance公钥的 SOL 余额，以 lamports 与 SOL 表示
getAccountInfo完整账户信息，可用时含 jsonParsed 解码
getMultipleAccounts单次调用批量最多 100 个账户
getProgramAccounts程序拥有的账户（热门程序需过滤器与 dataSlice）
getTokenAccountsByOwner钱包拥有的全部 SPL 代币账户
getTokenAccountBalance指定 SPL 代币账户余额
getTokenSupplySPL mint 总供应量
getTransaction按签名解析的交易
getSignaturesForAddress最近签名（通过 before / until 分页）
getBlock某槽位的区块元数据与交易
getSlot当前槽位
getEpochInfo纪元号、槽位索引、每纪元槽位数、进度
getNetworkStatus健康、版本、身份与槽位一次返回
getLatestBlockhash最新区块哈希 + lastValidBlockHeight
getFeeForMessage已编译消息的 lamport 费用
getMinimumBalanceForRentExemption免租金最小 lamports
getStakeActivation质押账户的生效/未生效 lamports 与状态
getRecentPrioritizationFees优先费用样本 + P50/P75/P90/P99 分位数
simulateTransaction模拟交易；返回日志与消耗单元
sendTransaction提交已签名的 base-64 交易

​
账户、资料与套餐

工具作用
setApiKey为会话存储 RPC 或客户 API 密钥，可选切换网络/区域
getProfile已认证用户资料 + 账户余额
updateProfile更新姓名、邮箱、支付钱包
listLicenses账户下全部 RPC 许可证
listRpcPlans可用套餐目录与定价

​
身份验证（设备码 + 钱包质询）

工具作用
requestDeviceCode启动设备授权流程；返回 verification_uri + user_code
pollDeviceToken轮询完成；成功时自动存储 Bearer 令牌
revokeToken注销 / 清除 Bearer 令牌
requestWalletChallenge获取 Solana 钱包的一次性质询字符串
verifyWalletSignature通过签名登录已有账户
registerWithWallet通过钱包签名创建新账户

​
API 密钥与许可证

工具作用
listApiKeys列出全部 API 密钥（掩码显示）
createApiKey创建新 API 密钥（完整密钥仅返回一次）
regenerateApiKey按 id 轮换（旧密钥立即失效）
deleteApiKey永久删除 API 密钥
addLicenseIp在 IP 模式许可证上白名单 IP
removeLicenseIp移除已白名单 IP
regenerateLicenseKey轮换许可证的 RPC 密钥

​
计费

工具作用
prepareTopUp构建未签名的 USDC 充值交易
confirmTopUp提交已签名充值；OrbitFlare 链上校验后记入余额
listInvoices分页发票列表
purchaseRpcPlan使用账户余额购买或 validateOnly 仅校验套餐

​
流式传输、质押、兑换

工具作用
subscribeTransactions为 OrbitFlare CLI 生成可用的 Jetstream 或 Yellowstone gRPC 配置
getStakeInfoOrbitFlare 验证者身份、投票账户、佣金、预估 APY、可选奖励计算器
getSwapQuoteJupiter Metis 路由报价（自动解析 SOL / USDC / USDT 符号）

​
钱包与写入

工具作用
generateKeypair生成 Ed25519 密钥对，可选持久化到 ~/.orbitflare/mcp-keypair.json
loadKeypair从 base58 密钥或 Solana CLI 密钥文件加载
clearKeypair从会话移除（并可从磁盘移除）
getWalletAddress返回已加载钱包地址
signMessage对任意消息进行 Ed25519 签名（utf8 / base58 / base64）
buildSolTransfer构建转账 SOL 的未签名版本化交易
buildStakeDelegation构建委托给 OrbitFlare 投票账户（或任意投票账户）的未签名交易
signAndSendTransaction使用会话密钥对签名，经 OrbitFlare RPC 广播

​
流程

​
身份验证（设备码）

1

请求设备码

requestDeviceCode 返回 verification_uri + user_code。模型会向你展示。
2

在浏览器中批准，然后轮询

pollDeviceToken { device_code } 按 interval 秒重复直至成功。Bearer 令牌自动存储并用于后续客户 API 调用。
3

退出登录

revokeToken 清除 Bearer 令牌。

​
身份验证（钱包）

1

加载密钥对

generateKeypair（新建）或 loadKeypair（来自 base58 / Solana CLI 文件）。
2

请求质询

requestWalletChallenge { wallet_address }。
3

签名并验证

signMessage { message: <challenge> }，然后 verifyWalletSignature（已有账户）或 registerWithWallet（新账户）。

​
钱包发送

1

加载密钥对

generateKeypair 或 loadKeypair。
2

构建转账

buildSolTransfer { recipient, amountSol } 返回 base64 未签名交易。
3

签名并广播

signAndSendTransaction { transaction } 使用会话密钥对签名、广播，并返回签名与 Solscan 链接。

​
充值

1

准备充值

prepareTopUp { amount, wallet_address } 返回 base64 未签名 USDC 转账 + memo。
2

签名

通过 signAndSendTransaction 使用已加载钱包签名，或在外部签名。
3

确认

confirmTopUp { transaction: <signed-base64> }。OrbitFlare 链上验证后记入余额。

​
资源

服务器将 OrbitFlare 文档暴露为 MCP 资源，模型可按需拉取当前文档：
URI页面
orbitflare://docs/index文档索引（llms.txt）
orbitflare://docs/quickstart快速入门
orbitflare://docs/authentication认证、端点、速率限制、连接限制
orbitflare://docs/products产品与定价
orbitflare://docs/rpc-httpHTTP RPC 参考
orbitflare://docs/jetstreamJetstream 流式传输
orbitflare://docs/yellowstoneYellowstone gRPC
orbitflare://docs/staking验证者质押
orbitflare://docs/metis-swapMetis Swap API
orbitflare://docs/cliOrbitFlare CLI
orbitflare://docs/customer-api客户 API v2

​
系统提示

预置的系统 / 开发者提示位于 system-prompts/orbitflare/ 目录：
  • claude.system.md：适用于 Claude 的简洁系统提示
  • openai.developer.md：适用于 OpenAI 模型的简洁开发者消息
  • full.md：长篇运营手册（认证流程、充值、严格护栏）
将其中一个放入主机配置，可为模型提供何时选用何种工具的端到端指导。

​
试用

安装后，模型会自动选择合适工具：
「Gh9ZwEm… 的 SOL 余额是多少？」
「显示 7xKXt… 最近 20 笔交易。」
「触碰涉及 Raydium 的账户时，当前有竞争力的优先费用是多少？」
「构建从法兰克福流式传输 Jupiter swap 交易的 Yellowstone gRPC 配置。」
「以 0.3% 滑点报价 1 SOL → USDC。」
「OrbitFlare 验证者投票账户是什么？250 SOL 每年约赚多少？」

​
源码