Universal Gas Framework MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RPC_OP | No | Optimism RPC URL | https://mainnet.optimism.io |
| RPC_ARB | No | Arbitrum RPC URL | https://arb1.arbitrum.io/rpc |
| RPC_BNB | No | BNB chain RPC URL | https://bsc-dataseed.binance.org |
| RPC_ETH | No | Ethereum mainnet RPC URL | https://eth.llamarpc.com |
| RPC_AVAX | No | Avalanche C-chain RPC URL | https://api.avax.network/ext/bc/C/rpc |
| RPC_BASE | No | Base RPC URL | https://mainnet.base.org |
| RPC_OPBNB | No | opBNB RPC URL | https://opbnb-mainnet-rpc.bnbchain.org |
| RPC_POLYGON | No | Polygon RPC URL | https://polygon-rpc.com |
| SUI_RPC_URL | No | Sui mainnet RPC URL | https://fullnode.mainnet.sui.io:443 |
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 |
|---|---|
| ugf_get_registryA | Fetch UGF's live payment token registry. Returns the list of supported payment coins (e.g. USDC, $U, ETH) and the chains each can be paid on, including token + vault contract addresses. Use this to discover viable routes without doing a quote. |
| ugf_check_balanceA | Read on-chain balance for a wallet on a supported EVM chain. Pass token_address='native' for the chain's native token, or an ERC-20 contract address. Returns the raw balance in atoms (smallest unit) as a decimal string. Stateless RPC read — no keys required. |
| ugf_get_nonceA | Fetch the UGF login nonce for a wallet address. Agent signs this nonce externally then calls ugf_authenticate. |
| ugf_authenticateA | Complete UGF login. Agent signs the nonce from ugf_get_nonce with its private key and passes the signature here. Returns JWT for agent to cache. |
| ugf_set_tokenA | Restore a cached UGF JWT on the MCP client. Use this on subsequent sessions to skip re-signing the nonce. |
| ugf_quoteB | Get a UGF quote for a specific payment coin and chain. Checks wallet balance against quote amount and returns whether the agent can proceed. |
| ugf_smart_quoteA | Auto-discover the best payment route. Fetches all wallet balances in parallel, gets quotes for every viable option, and returns ranked choices cheapest first. Agent just provides calldata and destination. |
| ugf_poll_statusA | Poll UGF route until completed/failed/expired. Use after payment to confirm execution. |
| ugf_check_statusB | Poll UGF route status by digest. Returns current status and completion state. |
| ugf_x402_build_typed_dataB | Build ERC-3009 x402 typed-data payload for local signing. Returns {domain, types, message, nonce, valid_after, valid_before}. Agent signs with signTypedData, then calls ugf_x402_submit_signed. |
| ugf_x402_submit_signedA | Submit a locally-signed x402 payload to UGF. Pair with ugf_x402_build_typed_data. |
| ugf_vault_build_txA | Build unsigned EIP-1559 vault payment tx for local signing + broadcast. Returns {to, data, value, chainId, gasLimit, nonce, type, maxFeePerGas, maxPriorityFeePerGas} — all BigInts as strings. Agent signs + broadcasts, then calls ugf_vault_submit_signed. |
| ugf_vault_submit_signedA | Submit proof of a locally-broadcast vault payment tx. Pair with ugf_vault_build_tx. |
| ugf_evm_wait_sponsorshipB | Wait until UGF sponsorship side is ready for a destination EVM tx. Agent then sends destination tx itself. |
| ugf_evm_confirm_user_txC | Confirm a user-broadcast destination EVM tx hash back to UGF. |
| ugf_sol_wait_user_sig_messageB | Wait for the Solana user-sig message UGF prepared. Returns {serialized_message: base64}. Agent signs locally with its keypair via nacl.sign.detached, then calls ugf_sol_submit_user_sig. |
| ugf_sol_submit_user_sigB | Submit a locally-produced Solana user signature to UGF. Pair with ugf_sol_wait_user_sig_message. |
| ugf_sui_wait_sponsor_bytesA | Wait for UGF to prepare Sui sponsor tx_bytes + sponsor_sig (base64). Agent signs tx_bytes locally with its Sui Ed25519 keypair, then calls ugf_sui_execute_signed_block. |
| ugf_sui_execute_signed_blockB | Broadcast a dual-signed (user + sponsor) Sui transaction block via Sui RPC. Returns {tx_digest}. |
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 19 tools
The tools are largely distinct by blockchain (EVM, Solana, Sui) and function (auth, balance, quote, submit). Paired operations like build/submit are clearly linked. Minor ambiguity exists between ugf_check_status and ugf_poll_status, but descriptions clarify that one polls until completion.
All tools start with 'ugf_' and use snake_case. Most follow a verb_noun pattern (e.g., ugf_check_balance, ugf_get_nonce). A few like ugf_authenticate omit the object, and ugf_smart_quote uses an adjective, but the overall pattern is predictable.
With 19 tools covering authentication, registry, balance, quoting, and payment operations across three blockchains plus EVM vault and x402, the count is well-scoped for the server's purpose. Each tool serves a clear role without bloat.
The tool surface covers the full lifecycle: discover (registry, balance), authenticate, quote, execute (per chain), and confirm. Missing are cancellation or withdrawal operations, but core payment workflows are complete.