Tools Reference

Complete reference for all tools available through Archer's MCP server. Tools are organized into two categories: read-only (no approval needed) and transactional (requires human approval in the webapp).

---

Read-Only Tools

These tools fetch data and do not modify any on-chain state. They can be called freely without transaction approval.

resolve_token

Look up token metadata by ticker symbol or contract address.

Parameters:

Name	Type	Required	Description
ticker	string	Yes	Token symbol (e.g., "USDC") or contract address
chain	string	No	Chain name (e.g., "ethereum", "arbitrum", "solana")

Example prompt: "Find the contract address for USDC on Arbitrum"

Returns: Token name, symbol, contract address, decimals, chain, CoinGecko ID

---

get_token_price

Get the current USD price for a token.

Parameters:

Name	Type	Required	Description
ticker	string	Yes	Token symbol (e.g., "ETH", "SOL")
chain	string	No	Chain for chain-specific pricing

Example prompt: "What's the price of SOL right now?"

Returns: Current USD price, 24h change percentage

---

get_user_balances

Fetch token balances across all connected chains for the authenticated user.

Parameters: None (uses the authenticated user's wallets)

Example prompt: "Show me my balances on all chains"

Returns: Array of token balances with chain, amount, and USD value

---

get_chain_capabilities

List all supported chains and their configurations.

Parameters: None

Example prompt: "What chains does Archer support?"

Returns: Chain names, IDs, native tokens, supported operations

---

get_swap_quote

Get a swap quote without executing. Useful for price comparisons.

Parameters:

Name	Type	Required	Description
fromToken	string	Yes	Source token symbol or address
toToken	string	Yes	Destination token symbol or address
amount	string	Yes	Amount to swap (human-readable, e.g., "100")
chain	string	Yes	Chain to execute on
slippage	number	No	Slippage tolerance (default: 0.5%)

Example prompt: "Quote swapping 100 USDC to ETH on Base"

Returns: Expected output amount, price impact, estimated gas, route details

---

get_bridge_quote

Get a cross-chain bridge quote without executing.

Parameters:

Name	Type	Required	Description
token	string	Yes	Token to bridge
amount	string	Yes	Amount to bridge
sourceChain	string	Yes	Source chain
destinationChain	string	Yes	Destination chain

Example prompt: "How much would it cost to bridge 0.5 ETH from Ethereum to Arbitrum?"

Returns: Expected output, bridge fee, estimated time, route provider

---

check_feasibility

Validate whether a transaction is feasible given current balances and chain state.

Parameters:

Name	Type	Required	Description
operation	string	Yes	Operation type: "swap", "bridge", or "send"
token	string	Yes	Token involved
amount	string	Yes	Amount
chain	string	Yes	Chain

Example prompt: "Can I swap 500 USDC to ETH on Arbitrum with my current balance?"

Returns: Feasibility status, current balance, gas estimate, any blockers

---

check_approval_status

Check the status of a pending transaction approval.

Parameters:

Parameter	Type	Required	Description
approvalId	string	Yes	The approval ID returned by a prepare_* tool

Example prompt: "What's the status of my pending swap?"

Returns: Approval status (PENDING, APPROVED, REJECTED, EXPIRED), transaction hash (if executed), and timestamps

---

Transactional Tools

These tools prepare on-chain transactions. When called, they create a Pending Approval in the Archer webapp that you must review and sign before the transaction is submitted.

prepare_swap_tx

Build a swap transaction for signing.

Parameters:

Name	Type	Required	Description
fromToken	string	Yes	Source token
toToken	string	Yes	Destination token
amount	string	Yes	Amount to swap
chain	string	Yes	Chain to execute on
slippage	number	No	Slippage tolerance

Example prompt: "Swap 50 USDC to ETH on Base"

Approval flow: Transaction details appear in the webapp. You review the swap parameters, expected output, and gas cost. Click Approve to sign and submit, or Reject to cancel.

---

prepare_bridge_tx

Build a cross-chain bridge transaction for signing.

Parameters:

Name	Type	Required	Description
token	string	Yes	Token to bridge
amount	string	Yes	Amount
sourceChain	string	Yes	Source chain
destinationChain	string	Yes	Destination chain

Example prompt: "Bridge 100 USDC from Ethereum to Arbitrum"

Approval flow: Transaction details appear in the webapp showing source chain, destination chain, amount, estimated time, and bridge fee.

---

prepare_send_tx

Build a token transfer transaction for signing.

Parameters:

Name	Type	Required	Description
token	string	Yes	Token to send
amount	string	Yes	Amount
toAddress	string	Yes	Recipient wallet address
chain	string	Yes	Chain to send on

Example prompt: "Send 0.1 ETH to 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18 on Ethereum"

Approval flow: Transaction details appear in the webapp showing recipient, amount, and gas cost. Safety check: the system blocks sends to known contract addresses to prevent accidental token loss.

---

Compute Unit Costs

Each tool call consumes Compute Units (CU). Approximate costs:

Tool	CU Cost
resolve_token	5
get_token_price	5
get_user_balances	20–50
get_chain_capabilities	2
get_swap_quote	30
get_bridge_quote	40
check_feasibility	8
check_approval_status	2
web_search	15
prepare_swap_tx	60
prepare_bridge_tx	75
prepare_send_tx	25

get_user_balances costs 20 CU for a single chain or 50 CU for all chains. Transaction tools cost more because they involve quote fetching, route optimization, and transaction construction.

Additional CU is consumed for LLM inference when the AI assistant processes your natural language prompt. The cost depends on the model tier: economy (~40 CU/request), standard (~145 CU/request), or premium (~350 CU/request).