agentkit-algovault

The Brain Layer for AI Trading Agents — AlgoVault's composite trade-call verdicts for Coinbase AgentKit, keyless free tier, served over the AlgoVault MCP server.

agentkit-algovault gives any AgentKit agent native access to AlgoVault's signal-interpretation tools. It is a walletless, read-only action provider that delegates to the AlgoVault MCP surface (api.algovault.com/mcp) over the Model Context Protocol — the scoring engine stays server-side and always current.

Actions

Action	Tool	Tier	What it returns
get_trade_call	get_trade_call	Free	Composite BUY / SELL / HOLD verdict for a crypto perp (or supported TradFi symbol), with confidence, market regime, funding, and reasoning.
get_trade_signal	get_trade_signal	Free	Alias of the trade call (kept for "give me a signal" phrasing).
get_market_regime	get_market_regime	Free*	Market-regime classification (trending / ranging / volatile) + cross-venue funding context.
scan_funding_arb	scan_funding_arb	Free*	Cross-venue funding-rate arbitrage opportunities, ranked by spread (free tier returns the top 5).

_{*Available keyless on the free tier; an ALGOVAULT_API_KEY raises request limits.}

The composite verdict aggregates indicators across exchanges. AlgoVault's PFE (peak-favourable-excursion) win-rate track record is published live at algovault.com.

Installation

npm install agentkit-algovault

@coinbase/agentkit is a peer dependency (bring your own version >=0.10.0):

npm install @coinbase/agentkit

Usage

Add algoVaultActionProvider() to your agent's action providers — keyless, zero config:

import { AgentKit } from "@coinbase/agentkit";
import { algoVaultActionProvider } from "agentkit-algovault";

const agentKit = await AgentKit.from({
  walletProvider, // your existing wallet provider — AlgoVault itself needs no wallet
  actionProviders: [
    algoVaultActionProvider(), // keyless free tier (100 calls/month)
  ],
});

The actions are then available to your agent (e.g. via getLangChainTools(agentKit) or the Vercel AI SDK extension). Ask it "AlgoVault trade call for BTC" and it calls get_trade_call and returns the verdict.

Configuration

Keyless (free tier) — nothing to configure. All four actions work without an API key (100 calls/month; scan_funding_arb returns the top 5).

Optional — raise request limits / unlock paid tiers with an API key, via config or env:

algoVaultActionProvider({ apiKey: process.env.ALGOVAULT_API_KEY });

Variable	Required	Description
ALGOVAULT_API_KEY	No	Unlocks paid limits. Omit for the keyless free tier. Sent as Authorization: Bearer.
ALGOVAULT_MCP_URL	No	Override the MCP endpoint. Defaults to https://api.algovault.com/mcp.

How it works

AgentKit agent ──▶ algovault action provider ──▶ @modelcontextprotocol/sdk
                                                   (Streamable HTTP)
                                                         │
                                                         ▼
                                            api.algovault.com/mcp  ──▶ verdict

The provider holds no scoring logic. Each action forwards its arguments to the named MCP tool and returns the server's verdict. Structured AlgoVault errors (e.g. an out-of-universe symbol) surface their suggested_* guidance so the agent can self-correct.

Staying in sync

The provider is a thin proxy, so its input schemas must track the live MCP tools. A version-sync canary fetches the live tools/list and asserts the four actions' fields still match the bundled schemas:

npm run check:schema          # exits non-zero on drift
npm run check:schema -- --simulate-drift   # proves the check fails on a mismatch

Development

npm install
npm test          # 25 unit tests (provider, schemas, utils — MCP client mocked)
npm run build     # → dist/ (ESM + .d.ts)
npm run check:schema

License

MIT

---

Try it now: npm i agentkit-algovault and add algoVaultActionProvider() to your agent — your first verdict is one keyless call away.

Built by AlgoVault Labs — composable, API-first signal-interpretation tools for AI agents.