Grimoire Morpho Blue
Pull Morpho Blue contract addresses, vault snapshots, and spell-ready params from chain via the Grimoire venue CLI.
Overview
Grimoire Morpho Blue is an agent skill for the Build phase that fetches Morpho Blue deployment metadata and vault snapshots using the Grimoire venue CLI.
Install
npx skills add https://github.com/franalgaba/grimoire --skill grimoire-morpho-blueWhat is this skill?
- Query adapter metadata with `grimoire venue morpho-blue info` and per-chain addresses
- Recommended preflight via `grimoire venue doctor --adapter morpho-blue` with RPC validation
- `--format spell` emits a `params:` snapshot block with provenance and APY fields
- APY reported as decimal rates (e.g. 0.0408 = 4.08%) with percent display guidance
- `vault-liquidity` for Morpho Vault V2 using onchain fields—not ERC-4626 maxWithdraw/maxRedeem
- Documents decimal APY semantics (example 0.0408 = 4.08%)
- Preflight doctor example uses chain id 8453
Adoption & trust: 1k installs on skills.sh; 5 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You are coding against Morpho Blue on Base or other chains but lack verified addresses, adapter status, and spell-ready param snapshots in one command.
Who is it for?
Indie builders wiring Grimoire spells, bots, or internal tools that must read Morpho Blue and Vault V2 liquidity without hand-copying explorers.
Skip if: Users who need generic Ethereum tutorials, wallet UX, or legal/compliance advice on yield products.
When should I use this skill?
You need Morpho Blue public deployment metadata, adapter info, or spell-oriented vault snapshots via Grimoire.
What do I get? / Deliverables
You obtain doctor-validated adapter metadata, per-chain addresses, and optional spell-format snapshots with APY and provenance for the next integration step.
- Per-chain Morpho Blue address lists
- Spell-format params blocks with snapshot provenance and APY
- Vault liquidity reads for Vault V2
Recommended Skills
Journey fit
Onchain venue metadata is integration work you do while building DeFi automations, spells, or agent tooling—not a generic marketing or validate-only task. Integrations subphase is where external protocols, RPCs, and CLIs get wired into your product or agent workflow.
How it compares
Protocol-specific Grimoire CLI integration—not a general-purpose DeFi MCP server or manual block-explorer scraping.
Common Questions / FAQ
Who is grimoire-morpho-blue for?
Developers already using Grimoire or Morpho Blue who want their agent to run the documented venue commands and interpret spell snapshots correctly.
When should I use grimoire-morpho-blue?
During Build integrations when you need contract addresses, adapter doctor checks, vault lists, or `--format spell` params before deploying onchain logic.
Is grimoire-morpho-blue safe to install?
It drives CLI calls that use your RPC URL and chain IDs—review Prism Security Audits on this page and never paste production keys into untrusted environments.
SKILL.md
READMESKILL.md - Grimoire Morpho Blue
# Grimoire Morpho Blue Skill Use this skill to query Morpho Blue deployment metadata and vault snapshots for spell params. Preferred invocations: - `grimoire venue morpho-blue ...` - `npx -y @grimoirelabs/cli venue morpho-blue ...` (no-install) - `bun run packages/cli/src/index.ts venue morpho-blue ...` (repo-local) - `grimoire-morpho-blue ...` (direct binary from `@grimoirelabs/venues`) Recommended preflight: - `grimoire venue doctor --adapter morpho-blue --chain 8453 --rpc-url <rpc> --json` Use `--format spell` to emit a `params:` snapshot block. The snapshot includes provenance fields (`snapshot_at`, `snapshot_source`) and APY data. Use `vault-liquidity` for Morpho Vault V2 vault-wide withdrawal liquidity. It reads onchain Vault V2 fields, caps Morpho Market V1 liquidity-adapter assets by available underlying market cash, and does not use ERC-4626 `maxWithdraw` / `maxRedeem`, which Vault V2 intentionally returns as `0`. APY semantics: - `apy` / `net_apy` are decimal rates (for example `0.0408` = `4.08%`). - When reporting, include both decimal and percent display when possible. ## Commands - `grimoire venue morpho-blue info` — adapter metadata - `grimoire venue morpho-blue addresses [--chain <id>]` — contract addresses per chain - `grimoire venue morpho-blue vaults [--chain <id>] [--asset <symbol>] [--min-tvl <usd>] [--min-apy <decimal>] [--min-net-apy <decimal>] [--sort <netApy|apy|tvl|totalAssetsUsd|name>] [--order <asc|desc>] [--limit <n>]` — list and filter vaults - `grimoire venue morpho-blue vaults-snapshot [--chain <id>] [--asset <symbol>] [--min-tvl <usd>] [--min-apy <decimal>] [--min-net-apy <decimal>] [--sort <netApy|apy|tvl|totalAssetsUsd|name>] [--order <asc|desc>] [--limit <n>]` — generate spell `params:` block for vaults (agent-only) - `grimoire venue morpho-blue vault-liquidity [--chain <id>] --vault <address> [--rpc-url <url>] [--format json|table|spell]` — read Morpho Vault V2 withdrawable liquidity in asset units and integer bps ## Examples ```bash grimoire venue morpho-blue info --format table grimoire venue morpho-blue addresses --chain 1 grimoire venue morpho-blue addresses --chain 8453 grimoire venue morpho-blue vaults --chain 8453 --asset USDC --min-tvl 5000000 --format table grimoire venue morpho-blue vaults --chain 8453 --asset USDC --min-tvl 5000000 --format spell grimoire venue morpho-blue vaults-snapshot --chain 8453 --asset USDC --min-tvl 5000000 grimoire venue morpho-blue vault-liquidity --chain 8453 --vault 0xbeef0e0834849aCC03f0089F01f4F1Eeb06873C9 --format json grimoire venue morpho-blue vault-liquidity --chain 8453 --vault 0xbeef0e0834849aCC03f0089F01f4F1Eeb06873C9 --format spell ``` Use `vaults-snapshot` to emit a `params:` block for spell inputs. This is an agent-only command (output suppressed in interactive mode). `vault-liquidity --format spell` emits payload-ready JSON params for `protocol: morpho-vault-v2`, `metric: withdrawable_liquidity_bps`, `withdrawable_liquidity_assets`, `total_assets`, `idle_assets`, `liquidity_adapter`, and `liquidity_adapter_assets`. Example provenance output fields to preserve: - `snapshot_at` - `snapshot_source` - `units` (for example `net_apy=decimal`, `net_apy_pct=percent`, `tvl_usd=usd`) ## Metric Surface (Spell Comparisons) Morpho exposes the `apy` metric surface and supports selector-based market targeting: ```spell morpho_apy_default = apy(morpho, USDC) morpho_apy_market = apy(morpho, USDC, "weth-usdc-86") morpho_apy_market_id = apy(morpho, USDC, "0x...") morpho_apy_generic = metric("apy", morpho, USDC, "wbtc-usdc-86") morpho_utilization_bps = metric("utilization_bps", morpho, USDC, "wbtc-usdc-86") vault_apy = metric("vault_apy", morpho, USDC, "vault=0xVaultAddress") vault_net_apy = metric("vault_net_apy", morpho, USDC, "vault=0xVaultAddress") vault_wit