Skip to content

feat(action-providers): add AlgoVault action provider - #1278

Open
AlgoVaultFi wants to merge 1 commit into
coinbase:mainfrom
AlgoVaultFi:feat/algovault-action-provider
Open

feat(action-providers): add AlgoVault action provider#1278
AlgoVaultFi wants to merge 1 commit into
coinbase:mainfrom
AlgoVaultFi:feat/algovault-action-provider

Conversation

@AlgoVaultFi

Copy link
Copy Markdown

Description

This PR adds a new AlgoVault action provider, giving AgentKit agents native access to AlgoVault's crypto trading signals: composite BUY/SELL/HOLD trade calls, market-regime classification, and cross-venue funding-rate arbitrage scanning.

  • Walletless + read-only data provider (supportsNetwork returns true for all networks), modeled on the existing messari / defillama providers.
  • Speaks MCP directly to the AlgoVault MCP server (api.algovault.com/mcp) over Streamable HTTP via @modelcontextprotocol/sdk (the same SDK already used in framework-extensions/model-context-protocol).
  • Keyless free tier — works out of the box, no API key required. An optional ALGOVAULT_API_KEY (constructor config or env var) unlocks paid-tier limits.
  • Actions (mirroring the live AlgoVault tools): get_trade_call (free), get_trade_signal (backward-compat alias), get_market_regime, scan_funding_arb.
  • zod input schemas mirroring the live tool inputs; structured error handling that surfaces AlgoVault's suggested_* guidance fields.
  • All verdicts are backed by AlgoVault's verified, on-chain (Base Merkle-anchored) track record: https://algovault.com/track-record

Tests

cd typescript/agentkit && pnpm test
# Test Suites: 61 passed, 61 total
# Tests:       889 passed, 889 total   (25 new for the algovault provider)

Live, keyless end-to-end invocation through the built provider (no API key — free tier):

Setup:  algoVaultActionProvider()           // keyless free tier
Prompt: get_trade_call { coin: "BTC" }
{
  "call": "HOLD",
  "confidence": 15,
  "price": 63875.4,
  "indicators": {
    "funding_rate": -0.00001279,
    "funding_state": "ELEVATED",
    "oi_change_pct": -3.7,
    "volume_24h": 30049729955.29,
    "trend_persistence": "HIGH",
    "underlying_session": "ALWAYS_OPEN"
  },
  "regime": "TRENDING_UP",
  "reasoning": "Trending regime, upward bias. Funding pressure elevated; one-sided crowd forming. Volatility neither expanding nor compressed. Trend persistence elevated; momentum structure. No actionable setup at this snapshot.",
  "coin": "BTC",
  "timeframe": "15m",
  "_algovault": { "version": "1.20.0", "tool": "get_trade_call", "exchange": "BINANCE" }
}

Checklist

  • Added documentation to all relevant README.md files
  • Added a changelog entry

Adds a walletless, read-only AlgoVault action provider that gives AgentKit
agents access to AlgoVault's crypto trading signals over the AlgoVault MCP
endpoint (api.algovault.com/mcp) via @modelcontextprotocol/sdk.

Actions: get_trade_call, get_trade_signal, get_market_regime, scan_funding_arb.
The free tier is keyless (no API key); an optional ALGOVAULT_API_KEY unlocks
paid tiers. Includes zod input schemas, structured error handling that surfaces
AlgoVault's suggested_* fields, unit tests, a README, and a changeset.
@AlgoVaultFi
AlgoVaultFi requested a review from murrlincoln as a code owner June 5, 2026 04:00
@cb-heimdall

Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@github-actions github-actions Bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Jun 5, 2026
@AlgoVaultFi

Copy link
Copy Markdown
Author

👋 Friendly nudge on this one. It's been ~11 days — CI is green on the auto-run checks (StepSecurity, labeler), and the Format / Lint / Unit-Test workflows are queued awaiting a maintainer's "Approve and run" (first-time contributor). It's a small, walletless, read-only provider: 4 actions over an MCP endpoint, keyless by default, 25 new tests, following the existing messari / defillama pattern. Happy to address any feedback quickly — thanks for taking a look! 🙏

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

2 participants