MCP Server

Bitwave MCP Server UNOFFICIAL

A Model Context Protocol server exposing Bitwave's crypto accounting platform through 41 tools spanning organization management, blockchain data, and pricing services.

41 Tools

3 Services

REST API

OAuth 2.0 Optional

Chat with DEMO Agent View on GitHub Download MCP Code

API-SVC — Organization & Accounting

Core accounting endpoints for managing your Bitwave organization, transactions, wallets, contacts, and integration connections. All tools in this group require OAuth authentication.

10 tools ⚿ OAuth Required

user_get ⎘ #01 OAuth Required

Get current authenticated user profile. Returns display name, email, user ID, and organization membership details.

JSON

{
  "id": "gZqWoj85...",
  "displayName": "Ore Phillips",
  "email": "ore@example.com"
}

org_get ⎘ #02 OAuth Required

Get organization details including name, subscription tier, member count, and configured base currency.

transactions_list ⎘ #03 OAuth Required

List transactions using the V2 API. Supports pagination and date range filtering for efficient querying of large transaction sets.

Parameters

Name	Type	Required	Description
limit	number	Optional	Maximum number of transactions to return
startDate	string	Optional	Start date filter (ISO 8601 format)
endDate	string	Optional	End date filter (ISO 8601 format)

wallets_list ⎘ #04 OAuth Required

List all wallets in the organization. Returns wallet addresses, names, networks, and associated metadata.

contacts_list ⎘ #06 OAuth Required

List contacts associated with the organization. Returns counterparty names, addresses, and labels.

connections_list ⎘ #07 OAuth Required

List all integrations and connections (exchanges, blockchains, ERPs) configured in the organization.

connection_get ⎘ #08 OAuth Required

Get details for a single integration connection by its unique identifier.

Parameters

Name	Type	Required	Description
connectionId	string	Required	Unique identifier of the connection

transactions_v1_list ⎘ #09 OAuth Required

List transactions using the V1 legacy API. Maintained for backward compatibility with older integrations.

transaction_v1_get ⎘ #10 OAuth Required

Get a single transaction by ID using the V1 legacy API.

Parameters

Name	Type	Required	Description
transactionId	string	Required	Unique identifier of the transaction

Address-SVC — Blockchain Data

On-chain data endpoints for querying balances, blocks, DeFi positions, token allowances, and exchange information across multiple blockchain networks. No authentication required.

19 tools ✓ Public — No Auth

coins_list ⎘ #11 Public

List all supported coins and tokens in the Bitwave registry. Returns coin IDs, symbols, names, and network mappings.

coin_get ⎘ #12 Public

Get detailed information about a specific coin by its Bitwave internal ID.

Parameters

Name	Type	Required	Description
coinId	string	Required	Bitwave internal coin identifier

JSON

{
  "id": "10",
  "symbol": "ETH",
  "name": "Ethereum",
  "networkId": "eth"
}

symbol_lookup ⎘ #13 Public

Look up a coin by its ticker symbol (e.g., ETH, BTC, USDC). Returns matching coin records.

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol to look up (e.g., "ETH", "BTC")

block_by_timestamp ⎘ #14 Public

Get the block number closest to a given Unix timestamp on a specific network.

Parameters

Name	Type	Required	Description
networkId	string	Required	Blockchain network identifier (e.g., "eth", "polygon")
timestampSEC	number	Required	Unix timestamp in seconds

block_by_number ⎘ #15 Public

Get block details by block number on a specific network. Returns timestamp, hash, and transaction count.

Parameters

Name	Type	Required	Description
networkId	string	Required	Blockchain network identifier
blockNumber	number	Required	Block number to look up

address_info ⎘ #16 Public

Get address info on a network including contract status, ENS resolution, and label data.

Parameters

Name	Type	Required	Description
networkId	string	Required	Blockchain network identifier
address	string	Required	Wallet or contract address

address_balance ⎘ #17 Public

Get address balance on a network. Returns native and token balances with optional asset filtering.

Parameters

Name	Type	Required	Description
networkId	string	Required	Blockchain network identifier
address	string	Required	Wallet address to query
asset	string	Optional	Filter by specific asset symbol or contract

JSON

{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f...",
  "balances": [
    {
      "asset": "ETH",
      "balance": "1.5432"
    }
  ]
}

address_supply ⎘ #18 Public

Get token supply information at a contract address. Returns total supply, circulating supply, and decimals.

Parameters

Name	Type	Required	Description
networkId	string	Required	Blockchain network identifier
address	string	Required	Token contract address

address_bulk_lookup ⎘ #19 Public

Bulk address lookup on a network. Query multiple addresses in a single request for efficient batch processing.

Parameters

Name	Type	Required	Description
networkId	string	Required	Blockchain network identifier
addresses	string	Required	Comma-separated list of addresses

address_active_networks ⎘ #20 Public

Get all active networks for an address. Identifies which blockchains have activity for a given wallet address.

Parameters

Name	Type	Required	Description
address	string	Required	Wallet address to query

asset_get ⎘ #21 Public

Get detailed asset information by its unique Bitwave asset ID including metadata and network details.

Parameters

Name	Type	Required	Description
id	string	Required	Bitwave asset identifier

defi_balance ⎘ #22 Public

Get DeFi protocol balance for a wallet. Queries a specific protocol for deposited assets, rewards, and LP tokens.

Parameters

Name	Type	Required	Description
networkId	string	Required	Blockchain network identifier
platformId	string	Required	DeFi protocol identifier (e.g., "aave-v3", "uniswap-v3")
ownerAddress	string	Required	Wallet address of the position owner

defi_positions ⎘ #23 Public

Get DeFi protocol positions including lending, borrowing, staking, and liquidity pool positions.

Parameters

Name	Type	Required	Description
networkId	string	Required	Blockchain network identifier
platformId	string	Required	DeFi protocol identifier
ownerAddress	string	Required	Wallet address of the position owner
block	number	Optional	Query positions at a specific block number

defi_position_balances ⎘ #24 Public

Get DeFi position balances with underlying token breakdown. Resolves LP tokens into constituent assets.

Parameters

Name	Type	Required	Description
networkId	string	Required	Blockchain network identifier
platformId	string	Required	DeFi protocol identifier
ownerAddress	string	Required	Wallet address of the position owner
block	number	Optional	Query position balances at a specific block number

token_allowance ⎘ #25 Public

Get ERC20 token allowance for a spender address. Check how much a contract is approved to spend on behalf of the owner.

Parameters

Name	Type	Required	Description
networkId	string	Required	Blockchain network identifier
tokenAddress	string	Required	ERC20 token contract address
ownerAddress	string	Required	Token owner wallet address
spenderAddress	string	Required	Approved spender address

exchange_symbol ⎘ #26 Public

Get exchange trading pair data including bid/ask, volume, and 24h change for a spot market.

Parameters

Name	Type	Required	Description
exchange	string	Required	Exchange identifier (e.g., "binance", "coinbase")
symbol	string	Required	Trading pair symbol (e.g., "ETH/USDT")

exchange_asset ⎘ #27 Public

Get exchange asset info including deposit/withdrawal status, fees, and supported networks.

Parameters

Name	Type	Required	Description
exchange	string	Required	Exchange identifier
symbol	string	Required	Asset symbol (e.g., "ETH", "BTC")

exchange_futures_list ⎘ #28 Public

List all available futures markets on an exchange including perpetuals and dated contracts.

Parameters

Name	Type	Required	Description
exchange	string	Required	Exchange identifier (e.g., "binance", "deribit")

exchange_futures_symbol ⎘ #29 Public

Get futures pair data including mark price, funding rate, open interest, and contract details.

Parameters

Name	Type	Required	Description
exchange	string	Required	Exchange identifier
symbol	string	Required	Futures pair symbol (e.g., "BTC/USDT:USDT")

Price-SVC — Pricing

Pricing service endpoints for historical prices, OHLCV data, asset metadata, and organization-specific pricing configuration. Some tools are public, others require authentication.

12 tools ⚠ Mixed Auth

price_health ⎘ #30 Public

Check Price-SVC health status. Returns service uptime, version, and data freshness indicators.

price_historical ⎘ #31 Public

Get historical OHLCV price data for a crypto-to-fiat pair. Defaults to the current timestamp if not specified.

Parameters

Name	Type	Required	Description
fromSym	string	Required	Source asset symbol (e.g., "ETH", "BTC")
toFiat	string	Required	Target fiat currency (e.g., "USD", "EUR")
timestampSEC	number	Optional	Unix timestamp in seconds (defaults to now)

JSON

{
  "fromSym": "ETH",
  "toFiat": "USD",
  "open": 2645.21,
  "high": 2680.50,
  "low": 2622.10,
  "close": 2671.33
}

price_v2 ⎘ #32 Public

Get V2 price with methodology metadata. Returns price, data sources, and calculation methodology used.

Parameters

Name	Type	Required	Description
from	string	Required	Source asset symbol
to	string	Required	Target asset or fiat symbol
timestampSEC	number	Optional	Unix timestamp in seconds

price_asset_metadata ⎘ #33 Public

Get asset metadata from Price-SVC including supported pricing methodologies and data source availability.

Parameters

Name	Type	Required	Description
symbol	string	Required	Asset symbol to query metadata for

price_jobs_list ⎘ #34 Public

List pricing sync jobs. Returns job status, schedule, last run time, and data freshness metrics.

org_assets_list ⎘ #35 OAuth Required

List all assets configured in the organization with pricing metadata and classification details.

org_asset_history ⎘ #36 OAuth Required

Get historical price data for an organization asset. Supports date range filtering and result limiting.

Parameters

Name	Type	Required	Description
assetId	string	Required	Organization asset identifier
fromTimestampSEC	number	Optional	Start of date range (Unix seconds)
toTimestampSEC	number	Optional	End of date range (Unix seconds)
limit	number	Optional	Maximum number of records to return

org_asset_current_price ⎘ #37 OAuth Required

Get the current live price of an organization asset with optional conversion to another asset.

Parameters

Name	Type	Required	Description
assetId	string	Required	Organization asset identifier
toAssetId	string	Optional	Target asset for conversion (defaults to org base currency)

org_asset_calc_price ⎘ #38 OAuth Required

Calculate an asset price at a specific timestamp using the organization's pricing methodology and directives.

Parameters

Name	Type	Required	Description
assetId	string	Required	Organization asset identifier
toAssetId	string	Optional	Target asset for conversion
timestampSEC	number	Optional	Unix timestamp in seconds for price calculation

org_coin_avg_price ⎘ #39 OAuth Required

Get average daily price for a coin. Used for daily accounting close and journal entry generation.

Parameters

Name	Type	Required	Description
coinId	string	Required	Bitwave coin identifier
date	string	Required	Date in YYYY-MM-DD format

org_dirty_prices ⎘ #40 OAuth Required

Check for dirty or stale prices that need recalculation. Used for data quality monitoring and reconciliation.

Parameters

Name	Type	Required	Description
priceIds	string	Optional	Comma-separated price record IDs to check (all if omitted)

org_pricing_directives ⎘ #41 OAuth Required

List pricing directives configured for the organization. Directives control pricing methodology, source priority, and override rules.

Parameters

Name	Type	Required	Description
pageToken	string	Optional	Pagination token for next page of results

Bitwave MCP Server UNOFFICIAL

API-SVC — Organization & Accounting

Address-SVC — Blockchain Data

Price-SVC — Pricing

Enter Access Code