Icon HelpCircleForumIcon Link

⌘K

Icon HelpCircleForumIcon Link
Nightly /
Common Commands

Icon LinkCommon MCP Tool Usage

Icon LinkBasic Function Calls

Icon LinkCall a simple function

{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "{\"functions\":[{\"name\":\"get_balance\",\"outputs\":[{\"type\":\"u64\"}]}]}",
    "function": "get_balance"
  }
}

Icon LinkCall with parameters

{
  "tool": "call_contract", 
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "https://api.example.com/contracts/0x1234.../abi.json",
    "function": "transfer",
    "function_args": ["\"0x5678...\"", "1000"]
  }
}

Icon LinkCall with complex types

// Tuple parameter (inline ABI)
{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "{\"functions\":[{\"name\":\"process_order\",\"inputs\":[{\"name\":\"order\",\"type\":\"(u64, bool, str)\"}]}]}", 
    "function": "process_order",
    "function_args": ["\"(42, true, \\\"urgent\\\")\""]
  }
}
 
// Struct parameter (URL ABI)
{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "https://contracts.fuel.network/abi/user-contract.json",
    "function": "create_user", 
    "function_args": ["\"{\\\"Alice\\\", 25, true}\""]
  }
}
 
// Array parameter (inline ABI)
{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "{\"functions\":[{\"name\":\"sum_values\",\"inputs\":[{\"name\":\"values\",\"type\":\"[u64; 5]\"}]}]}",
    "function": "sum_values",
    "function_args": ["\"[1, 2, 3, 4, 5]\""]
  }
}
 
// Enum parameter (URL ABI)
{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "https://api.example.com/contract-abi.json", 
    "function": "set_status",
    "function_args": ["\"(Active: true)\""]
  }
}

Icon LinkExecution Modes

Icon LinkDry-run (default)

{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "{\"functions\":[{\"name\":\"test_function\"}]}",
    "function": "test_function",
    "mode": "dry-run"
  }
}

Icon LinkSimulate (estimates gas)

{
  "tool": "call_contract", 
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "https://api.fuel.network/contracts/0x1234.../abi",
    "function": "test_function",
    "mode": "simulate"
  }
}

Icon LinkLive (state changes)

{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "{\"functions\":[{\"name\":\"test_function\"}]}", 
    "function": "test_function",
    "mode": "live",
    "signing_key": "your-private-key"
  }
}

Icon LinkPayable Functions

Icon LinkTransfer native asset

{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "{\"functions\":[{\"name\":\"deposit\",\"attributes\":[\"payable\"]}]}",
    "function": "deposit",
    "amount": 1000,
    "mode": "live"
  }
}

Icon LinkTransfer custom asset

{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "https://contracts.fuel.network/abi/token-vault.json", 
    "function": "deposit_token",
    "amount": 500,
    "asset_id": "0x5678...",
    "mode": "live"
  }
}

Icon LinkDirect Transfers

Icon LinkTransfer to address/contract

{
  "tool": "transfer_assets",
  "parameters": {
    "recipient": "0x1234...",
    "amount": 1000,
    "signing_key": "your-private-key"
  }
}

Icon LinkNetwork Selection

Icon LinkLocal node

{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "{\"functions\":[{\"name\":\"test\"}]}",
    "function": "test",
    "node_url": "http://127.0.0.1:4000"
  }
}

Icon LinkCustom node URL

{
  "tool": "call_contract", 
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "https://raw.githubusercontent.com/FuelLabs/sway-applications/main/contracts/abi.json",
    "function": "test",
    "node_url": "https://mainnet.fuel.network"
  }
}

Icon LinkList Functions

Icon LinkShow all callable functions

{
  "tool": "list_contract_functions",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "https://api.fuel.network/contracts/0x1234.../abi"
  }
}

Icon LinkUsing Different ABI Sources

Icon LinkRemote URL

{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "https://example.com/contract-abi.json",
    "function": "function_name"
  }
}
{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "{\"functions\":[{\"name\":\"get\",\"outputs\":[{\"type\":\"u64\"}]}]}",
    "function": "get"
  }
}

Icon LinkGitHub raw URL

{
  "tool": "call_contract",
  "parameters": {
    "contract_id": "0x1234...",
    "abi": "https://raw.githubusercontent.com/FuelLabs/sway-applications/main/AMM/project/contracts/exchange-contract/out/debug/exchange-contract-abi.json",
    "function": "function_name"
  }
}

Icon LinkExecution Trace

Icon LinkGet formatted execution trace

{
  "tool": "get_execution_trace",
  "parameters": {
    "trace_events": [/* trace events from call result */],
    "total_gas": 12345,
    "labels": {
      "0x1234...": "MyContract",
      "0x5678...": "TokenContract"
    }
  }
}