Lifi Mcp Skill

Capability Map

• Chain and token discovery:
  • get-chains
  • get-chain-by-id
  • get-chain-by-name
  • get-tokens
  • get-token
• Route discovery and provider availability:
  • get-connections
  • get-tools
• Quotes and route planning:
  • get-quote
  • get-routes
  • get-step-transaction
  • get-quote-with-calls
• Wallet prechecks:
  • get-native-token-balance
  • get-token-balance
  • get-allowance
  • get-gas-prices
  • get-gas-suggestion
• Monitoring and service checks:
  • get-status
  • test-api-key
  • health-check

Always inspect host help and operation help in the current endpoint version before relying on an operation name or argument shape.

Recommended Usage Pattern

1. Discover chain IDs dynamically:
   • lifi-mcp-cli get-chains
   • lifi-mcp-cli get-chain-by-name name=base
2. Resolve token addresses before quoting:
   • lifi-mcp-cli get-token chain=8453 token=USDC
3. Check whether a route exists before asking for a quote:
   • lifi-mcp-cli get-connections fromChain=8453 toChain=42161
4. Generate the quote:
   • lifi-mcp-cli get-quote fromChain=8453 toChain=42161 fromToken=USDC toToken=USDC fromAddress=<wallet> fromAmount=<smallest-unit-amount>
5. Validate execution preconditions:
   • lifi-mcp-cli get-allowance ...
   • lifi-mcp-cli get-native-token-balance ...
6. Use get-status only after the externally signed transaction has been broadcast.

Guardrails

• Keep automation on JSON output envelope; do not rely on --text.
• Parse stable fields first: ok, kind, protocol, data, error.
• Use lifi-mcp-cli as the default command path.
• lifi-mcp-cli <operation> ... is equivalent to uxc https://mcp.li.quest/mcp <operation> ... when the same auth binding is configured.
• Use direct uxc "<endpoint>" ... only as a temporary fallback when link setup is unavailable.
• Prefer key=value for simple arguments and positional JSON for nested objects.
• This endpoint is read-only from the agent perspective:
  • it does not sign transactions
  • it does not broadcast transactions
  • it returns unsigned transactionRequest objects for external wallet execution
• Do not present get-quote or get-step-transaction as executed trades; they are execution plans only.
• Before suggesting an ERC20 route as ready to execute, check allowance if the route needs approval.
• Prefer get-routes only when the user explicitly wants multiple alternatives; default to get-quote for the best route.
• In live testing, chain lookup tools accepted names, but token/balance/allowance tools were more reliable with numeric chain IDs. Prefer numeric IDs after discovery.

Tested Real Scenario

The endpoint was verified through uxc host discovery and returned a live MCP tool list including:

• get-allowance
• get-chain-by-id
• get-chain-by-name
• get-chains
• get-connections
• get-gas-prices
• get-gas-suggestion
• get-quote
• get-routes
• get-status
• get-token
• get-tokens
• get-tools
• health-check

This confirms the skill target is a real hosted MCP surface accessible via UXC.

References

• Invocation patterns:
  • references/usage-patterns.md