# Maestro

> Maestro Symphony blockchain query operations for OpenAgents agents, including tip freshness checks, address/UTXO/runes queries, and production-safe troubleshooting against deployed Symphony API endpoints.

- Skill: `tuyv/maestro` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add tuyv/maestro`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tuyv/maestro/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tuyv (https://skillmd.com/u/tuyv)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tuyv/maestro

---


# Maestro

## Overview

Use this skill when an agent needs to query a deployed Maestro Symphony API for Bitcoin chain/index data, validate freshness against a backend bitcoind tip, and run safe operational checks without exposing secrets.

This skill assumes OpenAgents GCP deployment conventions from `docs/deploy/SYMPHONY_GCP_RUNBOOK.md`.

## Inputs

Set these env vars before querying:

- `SYMPHONY_BASE_URL`: Symphony API base URL.
- `SYMPHONY_NETWORK`: expected network (`mainnet`, `testnet4`, or `regtest`).
- `BITCOIND_RPC_URL`: backend RPC endpoint.
- `BITCOIND_RPC_USER` / `BITCOIND_RPC_PASS`: backend RPC credentials.

Run preflight first:

```bash
skills/maestro/scripts/check-symphony-prereqs.sh
```

## Workflow

1. Verify API liveness and parse tip.
2. Validate chain freshness by comparing against bitcoind height.
3. Run address/runes query endpoints.
4. Enforce safety controls (`/dump` restricted, no secret logging, bounded polling).

## Quick commands

```bash
curl -fsS "${SYMPHONY_BASE_URL}/tip" | jq .

ADDR="bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
curl -fsS "${SYMPHONY_BASE_URL}/addresses/${ADDR}/tx_count" | jq .
curl -fsS "${SYMPHONY_BASE_URL}/addresses/${ADDR}/utxos" | jq .
curl -fsS "${SYMPHONY_BASE_URL}/addresses/${ADDR}/runes/balances" | jq .
```

## References

- [symphony-query-recipes](references/symphony-query-recipes.md)