convez.ai
MCP ServerFinanceiroIntermediário
AlgoVaultLabs

LlamaIndex Tools: AlgoVault

AlgoVaultLabs/llama-index-tools-algovault

Sinais de trading de crypto (BUY/SELL/HOLD) e arbitragem para agentes LlamaIndex

Ver no GitHub
InicialPluginScore · de 0 a 100

ToolSpec para LlamaIndex que integra sinais de trading de criptomoedas do AlgoVault, oferecendo verdicts compostos BUY/SELL/HOLD, classificação de regime de mercado e oportunidades de arbitragem cross-venue. Suporta tier gratuito (100 chamadas/mês) e tiers pagos, sem necessidade de API key para começar.

Instalação

$npx convez-ai AlgoVaultLabs/llama-index-tools-algovault

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Agentes de IA para pesquisa e análise de trading de criptomoedas
  • Identificação de oportunidades de arbitragem de taxa de financiamento entre exchanges
  • Classificação automática de regime de mercado (trend/range/volatilidade)
  • Automação de decisões de entrada/saída em operações de perpetuos

Veredito

Ferramenta sólida para agentes LlamaIndex operarem no mercado de crypto com verdicts compostos de trade. Acesso keyless gratuito remove fricção para prototipagem, mas o valor real está nos sinais pagos de arbitragem e regime; a trilha de performance pública no AlgoVault reforça confiabilidade.

README

A tradução para o português deste README ainda está na fila.

LlamaIndex Tools: AlgoVault

Composite BUY / SELL / HOLD trade calls, market‑regime classification, and cross‑venue funding‑arbitrage scans for crypto perpetual futures — exposed as native LlamaIndex tools, backed by the AlgoVault MCP server.

One import, zero MCP wiring, keyless free tier by default. Built by AlgoVault Labs.

pip install llama-index-tools-algovault

Why

AlgoVault is an API‑first signal‑interpretation layer for AI agents: it turns raw market data into a single composite verdict with a queryable, public track record. This ToolSpec gives a LlamaIndex agent four AlgoVault tools out of the box — no API key required to start (free tier), and a one‑line api_key for paid tiers.

The performance the verdicts are scored against (PFE win‑rate) is published live at algovault.com/track-record and via the MCP signal-performance resource.

Quick start (branded ToolSpec)

from llama_index.tools.algovault import AlgoVaultToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Keyless free tier (100 calls / month). Pass api_key="..." or set
# ALGOVAULT_API_KEY for paid tiers.
algovault = AlgoVaultToolSpec()

agent = FunctionAgent(
    tools=algovault.to_tool_list(),
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You are a crypto trading research assistant.",
)

resp = await agent.run("What's the current trade call for BTC?")
print(resp)

Call a tool directly:

algovault = AlgoVaultToolSpec()
print(algovault.get_trade_call("BTC"))                       # free
print(algovault.get_trade_call("ETH", timeframe="4h", exchange="BYBIT"))
print(algovault.get_market_regime("SOL", timeframe="1d"))    # paid tier
print(algovault.scan_funding_arb(min_spread_bps=5, limit=5)) # paid tier

Authentication

ModeHowTier
Keyless (default)AlgoVaultToolSpec()Free — 100 calls / month
API keyAlgoVaultToolSpec(api_key="...") or ALGOVAULT_API_KEY envPaid tiers

The key (when set) is sent as an Authorization: Bearer <key> header to https://api.algovault.com/mcp.

Tools

ToolTierSignatureReturns
get_trade_callFreecoin, timeframe?, exchange?, include_reasoning=True, asset_class?Composite BUY/SELL/HOLD verdict + confidence, price, indicators, regime, reasoning
get_trade_signalFree(same as get_trade_call)Alias of get_trade_call, kept for back‑compat
get_market_regimePaidcoin, timeframe="4h", exchange="HL"Regime: TRENDING_UP / TRENDING_DOWN / RANGING / VOLATILE
scan_funding_arbPaidmin_spread_bps=5, limit=10Cross‑venue funding‑rate spreads (long one venue, short the other)

timeframe ∈ 1m 3m 5m 15m 30m 1h 2h 4h 8h 12h 1d (regime: 1h 4h 1d). exchange ∈ HL BINANCE BYBIT OKX BITGET ASTER EDGEX GATE MEXC KUCOIN PHEMEX BINGX HTX WEEX BITMART XT WHITEBIT. Defaults match the AlgoVault server (timeframe=15m, exchange=BINANCE for trade calls). On the free tier scan_funding_arb caps limit at 5.

Alternative: generic MCP client (no package)

AlgoVault is a standard Streamable‑HTTP MCP server, so any LlamaIndex agent can reach the same tools through the generic llama-index-tools-mcp adapter — by configuration alone, no AlgoVault‑specific code:

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

# keyless free tier
client = BasicMCPClient("https://api.algovault.com/mcp")
# paid tiers:
# client = BasicMCPClient(
#     "https://api.algovault.com/mcp",
#     headers={"Authorization": "Bearer <ALGOVAULT_API_KEY>"},
# )

spec = McpToolSpec(
    client=client,
    allowed_tools=["get_trade_call", "get_trade_signal", "get_market_regime", "scan_funding_arb"],
)
tools = spec.to_tool_list()          # or: await spec.to_tool_list_async()

This package (llama-index-tools-algovault) is the branded, zero‑config, schema'd wrapper of that same surface: one import, the four tools pre‑wired with typed signatures and docstrings, keyless by default. Use whichever fits — they call the identical MCP endpoint.

Listing

Per run‑llama's current contribution policy, new integrations are published to PyPI independently rather than added to the run-llama/llama_index monorepo (which no longer accepts new integration packages). This package is therefore distributed via PyPI and GitHub; a LlamaHub catalog entry is requested separately through the directory's "Request an Integration" flow.

Development

uv run -- pytest -m "not live"   # unit tests
uv run -- pytest -m live -s      # live keyless call against api.algovault.com/mcp
uv build                         # sdist + wheel

Links


Built by AlgoVault Labs. MIT licensed.

Ver o original no GitHub

Bom para

Relacionados