Advan
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | HTTP server listen host. Default is 127.0.0.1; Docker sets 0.0.0.0. | 127.0.0.1 |
| PORT | No | HTTP server listen port. | 8787 |
| X402_PAY_TO | No | Recipient USDC address for x402 paid tools (token_risk and wallet_portfolio). The USDC token account must already exist. | |
| X402_NETWORK | No | x402 network CAIP identifier. Default is Solana devnet; mainnet is solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp. | solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1 |
| X402_RPC_URL | No | RPC URL used for x402 payment requirements. Defaults from X402_NETWORK and is never set from SOLANA_RPC_URL. | |
| MAX_TRADE_USD | No | Maximum trade size in USD. Set to 'off' to disable. A missing price refuses the trade while the cap is on. | 1000 |
| CDP_API_KEY_ID | No | Coinbase CDP API key ID. When set with CDP_API_KEY_SECRET, CDP is the primary x402 facilitator. | |
| FEE_CHECK_MODE | No | Fee validation mode. 'fail' withholds quotes/transactions when the referral fee is wrong; 'warn' returns them with feeCheck.ok false. | fail |
| SOLANA_RPC_URL | No | Solana RPC URL used for data reads and referral account checks. Defaults to the public mainnet-beta RPC. | |
| USAGE_LOG_PATH | No | Path to the JSONL usage log. The Docker image default is /data/usage.jsonl. | /data/usage.jsonl |
| X402_PRICE_USD | No | Price in USD per paid x402 call for token_risk and wallet_portfolio. | 0.01 |
| JUPITER_API_KEY | No | Optional Jupiter API key sent as x-api-key. Keyless access is rate-limited to about 0.5 requests per second. | |
| PUBLIC_BASE_URL | No | Public origin used for x402 resource URLs and Bazaar metadata when TLS is terminated by a proxy. | |
| MAX_INPUT_AMOUNT | No | Optional maximum input amount in base units. If unset, a startup warning is printed. | |
| MAX_SLIPPAGE_BPS | No | Maximum allowed slippage in basis points. | 300 |
| X402_PRICE_GUARD | No | Behavior when X402_PRICE_USD is below X402_MIN_FEE_MULTIPLE times the facilitator fee. 'warn' logs a warning; 'refuse' exits at startup. | warn |
| CDP_API_KEY_SECRET | No | Coinbase CDP API key secret. When set with CDP_API_KEY_ID, CDP is the primary x402 facilitator. | |
| ADVAN_ALLOWED_HOSTS | No | Allowed HTTP hosts when binding a public interface. | |
| MAX_PRICE_IMPACT_PCT | No | Maximum absolute price impact percentage. Jupiter's priceImpactPct is treated as a fraction. | 5 |
| X402_MIN_FEE_MULTIPLE | No | Minimum multiple of the applicable facilitator fee that X402_PRICE_USD must cover when X402_PRICE_GUARD is enforced. | 5 |
| JUPITER_REFERRAL_ACCOUNT | No | Jupiter referral account. If unset, orders are sent with no referral and a startup warning is logged. | |
| JUPITER_REFERRAL_FEE_BPS | No | Jupiter referral fee in basis points. Allowed range is 50–255; default is 50. | 50 |
| JUPITER_REFERRAL_REQUIRED | No | If true, refuses to boot without JUPITER_REFERRAL_ACCOUNT and wSOL, USDC, and USDT referral token accounts. | false |
| REFERRAL_MISSING_MINT_MODE | No | Behavior when a token-to-token route picks a fee mint without a configured referral token account. 'requote' requotes without referral fee, 'fail' refuses, 'warn' returns original with feeCheck.ok false. | requote |
| SWAP_SELF_BROADCAST_DEFAULT | No | Default for build_swap_tx selfBroadcast. When true, JupiterZ routes are excluded and the taker broadcasts the transaction. | false |
| X402_CDP_RECOVERY_INTERVAL_MS | No | Milliseconds to wait before probing a failed CDP facilitator again. Default is 5 minutes. | 300000 |
| JUPITER_REFERRAL_TOKEN_ACCOUNT_SOL | No | Referral token account for the wSOL fee mint. | |
| JUPITER_REFERRAL_TOKEN_ACCOUNT_USDC | No | Referral token account for the USDC fee mint. | |
| JUPITER_REFERRAL_TOKEN_ACCOUNT_USDT | No | Referral token account for the USDT fee mint. |
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_quoteA | Free Jupiter Swap API V2 quote (GET /swap/v2/order, no taker). Returns amounts, route, slippage, and referral fee fields. Does not return a transaction. |
| build_swap_txA | Free. Returns an UNSIGNED base64 transaction for the taker wallet to sign. Advan never signs and never holds keys. Default (selfBroadcast false) keeps JupiterZ routes, which need Jupiter POST /swap/v2/execute to add the market-maker co-signature. Pass selfBroadcast true to exclude jupiterz so the taker can broadcast the signed transaction. |
| token_riskA | Paid token risk report ($0.01 USDC via x402 exact on solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1). Combines RPC mint/freeze authority, Jupiter Tokens V2, and RugCheck. Ordinary MCP clients that cannot pay receive a payment-required error. |
| wallet_portfolioB | Paid wallet portfolio ($0.01 USDC via x402 exact). SOL plus SPL Token and Token-2022 balances, priced with Jupiter Price V3. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool maps to a distinct resource+action: risk report for a token, swap quote, transaction construction, and wallet holdings. token_risk and wallet_portfolio share the paid x402 mechanism but operate on entirely different inputs and outputs, so misselection is unlikely. Descriptions explicitly note free vs paid and what each returns, further reducing confusion.
Two tools are verb-first (get_quote, build_swap_tx) while two are noun-first (token_risk, wallet_portfolio), so there is no single predictable pattern. All are snake_case and readable, and the semantic grouping (noun = data report, verb = action) is at least defensible, but an agent cannot infer a name from intent reliably.
Four tools is on the lean side but each earns its place in a focused swap/portfolio workflow, with no redundant or filler tools. The free/paid split is coherent. Slightly under-scoped rather than bloated.
The quote→build_tx→external-sign flow is covered and portfolio/risk reads exist, but there is no tool to submit or check transaction status (broadcasting is delegated to the taker with no confirmation path), and no token lookup/metadata or SPL balance query for a specific mint. These gaps are workable but will surface as dead ends for agents verifying outcomes.