1
// Create via API or dashboard, then reference by ID
2
const externalTool = {
3
  name: 'get_weather',
4
  description: 'Get current weather for a city',
5
  toolType: 'external',
6
  parametersSchema: {
7
    type: 'object',
8
    properties: {
9
      city: { type: 'string', description: 'City name' }
10
    },
11
    required: ['city']
12
  },
13
  config: {
14
    url: 'https://api.weather.com/v1/current?city={{city}}',
15
    method: 'GET',
16
    headers: {
17
      'Authorization': 'Bearer {{secrets.weather_api_key}}'
18
    }
19
  }
20
}

1
const customTool = {
2
  name: 'calculate_discount',
3
  description: 'Calculate discounted price',
4
  toolType: 'custom',
5
  parametersSchema: {
6
    type: 'object',
7
    properties: {
8
      price: { type: 'number' },
9
      discount: { type: 'number' }
10
    },
11
    required: ['price', 'discount']
12
  },
13
  config: {
14
    code: `
15
      const discounted = price * (1 - discount / 100);
16
      return {
17
        original: price,
18
        discounted: discounted.toFixed(2),
19
        savings: (price - discounted).toFixed(2)
20
      };
21
    `,
22
    timeout: 5000
23
  }
24
}

1
tools: {
2
  toolIds: [
3
    'builtin:dalle',              // DALL-E image generation
4
    'builtin:web_search'          // Web search (provider-dependent)
5
  ]
6
}

1
tools: {
2
  toolIds: [
3
    'mcp:context7:resolve-library-id',  // Context7 docs server
4
    'mcp:myslack:send_message',         // Your saved Slack server
5
    'mcp:notion:create_page'            // Your saved Notion server
6
  ]
7
}

1
tools: {
2
  mcpServers: [{
3
    id: 'notion',
4
    url: 'https://my-notion-mcp.example.com/mcp',
5
    auth: {
6
      type: 'bearer',
7
      token: process.env.NOTION_MCP_TOKEN
8
    },
9
    timeout: 30000
10
  }]
11
}

1
tools: {
2
  runtimeTools: [{
3
    name: 'fetch_user',
4
    description: 'Fetch user by ID',
5
    toolType: 'external',
6
    parametersSchema: {
7
      type: 'object',
8
      properties: {
9
        userId: { type: 'string' }
10
      },
11
      required: ['userId']
12
    },
13
    config: {
14
      url: 'https://api.example.com/users/{{userId}}',
15
      method: 'GET'
16
    }
17
  }]
18
}

1
tools: {
2
  // Saved tools (by ID)
3
  toolIds: [
4
    'tool_abc123',                       // Custom saved tool
5
    'builtin:dalle',                     // Built-in tool
6
    'mcp:slack:send_message'             // Saved MCP server tool
7
  ],
8
  // Inline runtime tools
9
  runtimeTools: [
10
    { name: 'temp_tool', ... }
11
  ],
12
  // Runtime MCP servers
13
  mcpServers: [
14
    { id: 'dynamic', url: '...', auth: {...} }
15
  ],
16
  maxToolCalls: 15,
17
  toolCallStrategy: 'auto'
18
}

1
const result = await client.dispatch({
2
  flow: { ... },
3
  secrets: {
4
    weather_api_key: process.env.WEATHER_API_KEY,
5
    notion_token: process.env.NOTION_TOKEN
6
  }
7
})