Skip to main content
Glama
Octav API MCP Server

Octav API MCP Server

Official
by Octav-Labs

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OCTAV_API_KEYYesYour Octav API key from https://octav.fi/api

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
octav_get_portfolioA

Get complete portfolio including wallet holdings and DeFi protocol positions across 20+ blockchains. Returns token balances, values, and protocol positions. Waits for a fresh sync by default. Costs 1 credit per address.

octav_get_walletA

Get wallet holdings only (excludes DeFi protocols). Returns token balances and values across all chains. Costs 1 credit per address.

octav_get_navA

Get total net worth (NAV) in specified currency. Supports USD, EUR, CAD, AED, CHF, SGD, ETH, SOL, cbBTC, EURC, BNB, WHYPE. Costs 1 credit per address.

octav_get_token_overviewA

Get aggregated token distribution across all chains. Shows which tokens you hold, their values, and percentage breakdown. Costs 1 credit per address.

octav_get_portfolio_at_blockA

Get a single EVM address's portfolio valued at a specific block on ethereum, linea or monad, with every balance and price as of that block. Requires the Portfolio at Block add-on. Costs 1 credit.

octav_get_transactionsB

Query transaction history with filtering and pagination. Filter by chain, type, protocol, counterparty, text search, NFT token ID, and date range, and hide spam or dust. Max 250 transactions per request. Costs 1 credit per address.

octav_sync_transactionsA

Manually trigger transaction synchronization for one address. Forces immediate indexing of latest transactions. Costs 1 credit, plus 1 credit per 250 transactions indexed.

octav_get_historicalA

Get portfolio snapshot for a specific date in the past. Shows holdings and values at that point in time. Costs 1 credit per address.

octav_subscribe_snapshotA

Subscribe to automatic portfolio snapshots. Enables historical tracking. Costs 1200 credits. API expects addresses with optional descriptions.

octav_get_statusA

Check synchronization status of addresses across all chains. Shows which chains are synced and last sync time. FREE - no credits required.

octav_get_creditsA

Check API credit balance, usage, and remaining credits. FREE - no credits required.

octav_get_chainsA

List every chain Octav supports, with its key (used by chain filters in other tools), name, chain id, and whether portfolio and transactions are supported. FREE - no credits required.

octav_get_chain_protocolsA

List the DeFi protocols Octav tracks on a chain, with their keys (used by the protocol filter on octav_get_transactions). Paginated; the response says whether more pages exist. FREE - no credits required.

octav_get_contract_protocolA

Identify the DeFi protocol a contract address belongs to, such as a spender from octav_get_approvals or a transaction counterparty. With a chain it returns { protocol }; without one it returns { protocols } for every chain the address is known on. Costs 5 credits, refunded if no protocol is found.

octav_get_airdropA

Check airdrop eligibility for Solana address. Shows eligible airdrops with claim links. Solana addresses only. Costs 1 credit.

octav_get_polymarketA

Get the Polymarket prediction market positions and collateral of a Polymarket (proxy) wallet. Pass the proxy wallet itself, as shown on the Polymarket profile; a regular wallet's proxy is not looked up. Costs 1 credit.

octav_get_approvalsA

Get the ERC-20 token approvals (allowances) a wallet has granted to spender contracts on one chain. Paginated: pass the returned cursor to get the next page; there are no more pages when it is absent or null. Costs 1 credit.

octav_list_virtual_usersA

List the virtual users on the account (balance-tracking or CEX-linked accounts managed in Octav Pro), with their virtual: address, type, and label. Requires Pro. Costs 1 credit.

octav_get_virtual_users_portfolioA

Get portfolios for virtual users, using the virtual: addresses from octav_list_virtual_users. Same shape as octav_get_portfolio; set aggregated for one combined portfolio. Waits for a fresh sync by default. Requires Pro. Costs 1 credit per address.

octav_list_address_bookA

List every address saved in the account address book (the same list shown in Octav Pro), with its label, plan (FREE, LITE, PRO), plan expiry, and whether the plan is paid. Costs 1 credit.

octav_add_address_book_entriesA

Save addresses (EVM, Solana, Starknet, or Tron) to the address book, each with an optional label. An address already in the book keeps its existing label; use octav_rename_address_book_entry to change it. Accounts without a paid plan can save up to 50 addresses. Returns the full address book. Costs 1 credit.

octav_rename_address_book_entryA

Change the label on an address already in the address book, replacing the current one. Pass an empty string to clear the label. Requires confirm: true. Costs 1 credit.

octav_remove_address_book_entryA

Remove an address from the address book. Entries on a paid plan or authorized by the wallet owner cannot be removed through the API; they must be removed in Octav Pro. Requires confirm: true. Costs 1 credit.

octav_list_bundlesA

List every bundle (a named group of address book addresses, as in Octav Pro) with its id, name, and addresses. Pass a bundle's addresses to octav_get_portfolio to see its holdings. Costs 1 credit.

octav_get_bundleA

Get one bundle by id, with its name and addresses. Use octav_list_bundles to find bundle ids. Costs 1 credit.

octav_create_bundleA

Create a named bundle from addresses that are already in the address book (save them first with octav_add_address_book_entries). Names must be unique (case-sensitive), a bundle cannot be empty, and no two bundles may hold exactly the same addresses. Default limits are 5 bundles and 10 addresses per bundle. Bundles created through the API are private. Costs 1 credit.

octav_rename_bundleA

Rename a bundle, replacing its current name. Names must be unique (case-sensitive). Requires confirm: true. Costs 1 credit.

octav_delete_bundleA

Delete a bundle. Its addresses stay in the address book. Requires confirm: true. Costs 1 credit.

octav_add_bundle_addressA

Add one address to a bundle. The address must already be in the address book. Returns the updated bundle. Costs 1 credit.

octav_remove_bundle_addressA

Remove one address from a bundle; it stays in the address book. A bundle cannot be emptied, so to remove its last address delete the bundle instead. Requires confirm: true. Returns the updated bundle. Costs 1 credit.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.9/5.0

Scored across 30 tools

Disambiguation4/5

Most tools target clearly distinct resources (transactions, approvals, chains, credits, address book, bundles, virtual users) and the descriptions do real work separating them. The weak spot is a cluster of five portfolio-valued reads — get_portfolio, get_wallet, get_nav, get_token_overview, get_historical, get_portfolio_at_block — which an agent could easily mix up despite the distinctions being spelled out.

Naming Consistency5/5

Every tool uses the same octav_verb_noun snake_case pattern with a small, predictable verb set (get, list, create, add, remove, rename, delete, sync, subscribe). Sub-resources like address_book_entry and bundle_address are named consistently across their CRUD families.

Tool Count3/5

30 tools is heavy and sits at the upper bound; the surface splits into many small families (address book CRUD, bundle CRUD, virtual users, metadata, credits, prediction markets). Each tool is defensible individually, but the aggregate is sprawling and the portfolio-read variants inflate the count.

Completeness4/5

Coverage is broad: portfolio/holdings, historical snapshots, transactions plus sync, approvals, chains and protocols, credits, and full CRUD for both address book entries and bundles. Minor gaps remain, such as single-transaction detail or per-token lookups, but agents can work around them via the existing list and filter endpoints.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues