# Beefy Finance

> Beefy Finance API — 10 operations.

MCP endpoint: https://beefy.mcp.junct.dev/mcp
Domain: yield
Auth: none

## Tools

### get_api_v1_status
[DISCOVERY] GET /api/v1/status Returns: { arbitrum: { subgraph: string, tag: string, blockNumber: string, timestamp: string, hasErrors: boolean }[], avax: { subgraph: string, tag: string, blockNumber: string, timestamp: string, hasErrors: boolean }[], base: { subgraph: string, tag: string, blockNumber: string, timestamp: string, hasErrors: boolean }[], ... }.

_No parameters required._

> Call this first to discover valid IDs/slugs.

### get_api_v1_investor_investor_address_timeline
GET /api/v1/investor/{investor_address}/timeline

**Parameters:**
- `investor_address` (string, required): path parameter: investor_address (string)

### get_api_v1_vault_chain_vault_address_price
GET /api/v1/vault/{chain}/{vault_address}/price

**Parameters:**
- `chain` (string, required): path parameter: chain ("arbitrum" | "avax" | "base" | "berachain" | "bsc" | "gnosis" | "hyperevm" | "linea" | "lisk" | "manta" | "mantle" | "megaeth" | "mode" | "monad" | "moonbeam" | "optimism" | "plasma" | "polygon" | "rootstock" | "saga" | "scroll" | "sei" | "sonic" | "zksync")
- `vault_address` (string, required): path parameter: vault_address (string)

### get_api_v1_vault_chain_vault_address_harvests
GET /api/v1/vault/{chain}/{vault_address}/harvests

**Parameters:**
- `chain` (string, required): The chain the vault is on
- `vault_address` (string, required): The vault contract address

### get_api_v1_vault_chain_vault_address_prices_period_since
GET /api/v1/vault/{chain}/{vault_address}/prices/{period}/{since}

**Parameters:**
- `chain` (string, required): The chain the vault is on
- `vault_address` (string, required): The vault contract address
- `period` (string, required): The snapshot period for prices
- `since` (string, required): The unix timestamp to start from

### get_api_v1_vault_chain_vault_address_prices_range_period
GET /api/v1/vault/{chain}/{vault_address}/prices/range/{period} Returns: { min: number, max: number }.

**Parameters:**
- `chain` (string, required): The chain the vault is on
- `vault_address` (string, required): The vault contract address
- `period` (string, required): The snapshot period for prices

### get_api_v1_vault_chain_vault_address_investors
Get all investor positions for a vault Returns: { investor_address: string, total_shares_balance: string, underlying_balance0: string, ... }.

**Parameters:**
- `chain` (string, required): The chain the vault is on
- `vault_address` (string, required): The vault contract address

### get_api_v1_vault_chain_vault_address_move_ticks
Get all move ticks for a vault — Get all move ticks for a vault, excluding deposits and withdrawals

**Parameters:**
- `start_time` (string, optional): Start timestamp (inclusive)
- `end_time` (string, optional): End timestamp (exclusive)
- `chain` (string, required): The chain the vault is on
- `vault_address` (string, required): The vault contract address

### get_api_v1_vaults_chain_period
GET /api/v1/vaults/{chain}/{period}

**Parameters:**
- `chain` (string, required): The chain the vault is on
- `period` (string, required): The period to return APR for

### get_api_v1_vaults_chain_harvests_since
GET /api/v1/vaults/{chain}/harvests/{since}

**Parameters:**
- `vaults` (array, optional): The vault addresses to return harvests for
- `chain` (string, required): The chain to return vaults harvest data for
- `since` (number, required): The unix timestamp to return harvests since

## Usage

Connect to this MCP server at `https://beefy.mcp.junct.dev/mcp`. All tools are callable via the MCP protocol.
Call `get_api_v1_status` first to discover valid identifiers required by other tools.