bds-agent

Python package and CLI for building agents on Powerloom BDS data markets — verified, epoch-based blockchain data served over metered HTTP.

Features

• Signup & Credits — device-auth or wallet-funded API key provisioning against the metering service
• Run — stream snapshots via SSE, apply declarative rules, dispatch to sinks (Slack, Telegram, Discord, webhook, stdout)
• Query — natural-language → catalog route + params (LLM-powered); optional --execute for one-shot BDS calls
• Create — natural-language → agent.yaml scaffold (LLM-powered)
• MCP server — stdio-based MCP exposing BDS catalog as tools for Claude, Cursor, LangGraph, CrewAI, etc.
• LLM backends — Anthropic, OpenAI-compatible, Ollama (local)
• On-chain verification — optional CID verification against ProtocolState.maxSnapshotsCid

Installation

# Install using pip
pip install bds-agent

# Install using pipx (recommended for CLI use)
pipx install bds-agent

# Install using uv
uv tool install bds-agent

Quick Start

# Sign up for an API key (opens browser for device-auth)
bds-agent signup

# Check your credit balance
bds-agent credits balance

# Run an agent from a YAML definition
bds-agent run agent.yaml

# Natural-language query against the BDS catalog
bds-agent query "top 5 Uniswap V3 pools by 24h volume"

# Generate an agent.yaml from a description
bds-agent create "alert me on Slack when any ETH/USDC swap exceeds $50k"

# Start the MCP server (stdio) for AI framework integration
bds-agent mcp

Available Commands

Requirements

• Python 3.12 or higher

Documentation

• User Guide
• Agent YAML Schema
• Rules Reference
• Sinks Reference
• GitHub Repository
• Powerloom Website

License

MIT License — see LICENSE for details.

Support

• Report Issues
• Discord Community