Tools Reference

Comprehensive documentation for all 30+ integrated tools. Web search, code interpreter, weather, stocks, and more.

All Available Tools

Complete list of 30 tools you can use with the API

web_searchacademic_searchextreme_searchreddit_searchx_searchyoutube_searchtrove_searchcode_interpreterrag_searchstock_pricestock_chartcurrency_convertercoin_datacoin_data_by_contractcoin_ohlcweatherfind_place_on_mapnearby_places_searchflight_trackerflight_live_trackertravel_advisormovie_tv_searchtrending_moviestrending_tvdatetimetext_translatemermaid_diagrammemory_managerretrievegreeting

Tool Details

Search and explore tool specifications

web_search

Search & Research

Search the web for current information

Parameters

query(string)*- Search query

Example

{
  "name": "web_search",
  "arguments": {
    "query": "latest AI developments 2024"
  }
}

academic_search

Search & Research

Search academic papers and research

Parameters

query(string)*- Academic search query

Example

{
  "name": "academic_search",
  "arguments": {
    "query": "quantum computing applications"
  }
}

extreme_search

Search & Research

Deep multi-source research

Parameters

query(string)*- Research query

Example

{
  "name": "extreme_search",
  "arguments": {
    "query": "climate change mitigation strategies"
  }
}

reddit_search

Search & Research

Search Reddit posts and discussions

Parameters

query(string)*- Search query

subreddit(string)- Specific subreddit

sortBy(string)- Sort by: relevance, hot, top, new

timeFilter(string)- Time filter: all, year, month, week, day

Example

{
  "name": "reddit_search",
  "arguments": {
    "query": "best programming languages 2024",
    "sortBy": "top",
    "timeFilter": "month"
  }
}

code_interpreter

Code & Data

Execute Python code in a sandboxed environment

Parameters

title(string)*- Title for the code execution

code(string)*- Python code to execute

icon(string)*- Icon type: stock, date, calculation, default

Example

{
  "name": "code_interpreter",
  "arguments": {
    "title": "Calculate Fibonacci",
    "code": "def fib(n):\n    if n <= 1: return n\n    return fib(n-1) + fib(n-2)\n\nprint([fib(i) for i in range(10)])",
    "icon": "calculation"
  }
}

stock_price

Finance

Get current stock prices

Parameters

symbol(string)*- Stock ticker symbol (e.g., AAPL)

Example

{
  "name": "stock_price",
  "arguments": {
    "symbol": "AAPL"
  }
}

currency_converter

Finance

Convert between currencies

Parameters

amount(number)*- Amount to convert

from(string)*- Source currency code

to(string)*- Target currency code

Example

{
  "name": "currency_converter",
  "arguments": {
    "amount": 100,
    "from": "USD",
    "to": "EUR"
  }
}

coin_data

Finance

Get cryptocurrency data

Parameters

coinId(string)*- Coin ID (e.g., bitcoin, ethereum)

Example

{
  "name": "coin_data",
  "arguments": {
    "coinId": "bitcoin"
  }
}

weather

Location & Travel

Get weather information

Parameters

location(string)*- City name or location

latitude(number)- Latitude coordinate

longitude(number)- Longitude coordinate

Example

{
  "name": "weather",
  "arguments": {
    "location": "Sydney"
  }
}

flight_tracker

Location & Travel

Track flights between airports

Parameters

departure(string)*- Departure airport code

arrival(string)*- Arrival airport code

date(string)- Date (YYYY-MM-DD)

Example

{
  "name": "flight_tracker",
  "arguments": {
    "departure": "SYD",
    "arrival": "MEL",
    "date": "2024-02-15"
  }
}

movie_tv_search

Entertainment

Search for movies and TV shows

Parameters

query(string)*- Movie or TV show name

Example

{
  "name": "movie_tv_search",
  "arguments": {
    "query": "Inception"
  }
}

text_translate

Utilities

Translate text between languages

Parameters

text(string)*- Text to translate

targetLanguage(string)*- Target language code (e.g., fr, es, ja)

Example

{
  "name": "text_translate",
  "arguments": {
    "text": "Hello world",
    "targetLanguage": "fr"
  }
}

mermaid_diagram

Utilities

Create Mermaid diagrams

Parameters

content(string)*- Mermaid diagram syntax

Example

{
  "name": "mermaid_diagram",
  "arguments": {
    "content": "graph TD\n    A[Start] --> B[Process]\n    B --> C[End]"
  }
}

Auto Mode

Let the AI automatically choose which tools to use

Instead of specifying which tools to use, you can set tool_choice: "auto"and let the AI decide based on the user's request.

{
  "model": "llama-4",
  "messages": [
    {
      "role": "user",
      "content": "What's the weather in Paris and book me a flight from Sydney?"
    }
  ],
  "tools": [
    // Include all relevant tools
  ],
  "tool_choice": "auto"  // AI will use weather and flight_tracker
}

auto

AI decides whether and which tools to use

none

Disable tool use for this request

required

Force the AI to use at least one tool

Auto Tool Selection

Let AI automatically choose the right tools for complex tasks

Use "tools": ["auto"] in your API requests to enable intelligent tool selection. The AI will automatically choose from all available tools based on the user's request.

See Tools in Action

View practical examples of how to use each tool effectively

Start Building

Get your API key and integrate these powerful tools

Need custom tools or enterprise integrations?