用途:该技能通过 uxc 运行 Birdeye MCP 操作,面向只读的行情与发现类工作流,包括代币市场数据、趋势或发现视图、价格监控、DEX 流动性或交易上下文、代币或交易对查询。它被定位为只读市场与发现访问,而非交易或执行接口。
前提条件:uxc 已安装并在 PATH 中;可访问 https://mcp.birdeye.so/mcp;持有 Birdeye API key。
主要用法:先用帮助探测确认端点与协议,执行 uxc https://mcp.birdeye.so/mcp -h,当前未认证预期返回 401 Unauthorized。随后配置凭据与绑定,例如 uxc auth credential set birdeye-mcp --auth-type api_key --header "X-API-KEY={{secret}}" --secret-env BIRDEYE_API_KEY,或使用 --secret-op op://Engineering/birdeye/api-key;再执行 uxc auth binding add --id birdeye-mcp --host mcp.birdeye.so --path-prefix /mcp --scheme https --credential birdeye-mcp --priority 100。默认使用固定链接命令,先检查 command -v birdeye-mcp-cli,缺失时用 uxc link birdeye-mcp-cli https://mcp.birdeye.so/mcp 创建,然后 birdeye-mcp-cli -h 查看实时工具列表,并用 <operation> -h 查看具体操作。
建议模式:从单一聚焦的读取目标开始,如某代币当前行情、趋势代币或叙事发现、DEX 流动性或价格变动检查;先运行主机帮助再运行操作帮助;优先使用窄范围的符号、地址或链,再考虑宽泛扫描;先解析 JSON 信封再检查数据。
限制与注意:自动化应依赖 JSON 输出信封而非 --text,优先解析 ok、kind、protocol、data、error 等稳定字段。若探测或运行返回 401,可用 uxc auth binding match https://mcp.birdeye.so/mcp 确认绑定、用 uxc auth credential info birdeye-mcp 确认凭据形态,必要时重置为 API-key 头。Birdeye MCP 仍处于 beta,实时工具面可能独立于该封装技能变化,不要硬编码工具列表或参数名,应先查看 -h;初始查询应保持小而具体,因为市场与发现工具可能返回宽泛数据集。参考资料为 references/usage-patterns.md。