For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
  • Getting Started
    • What is Runtype?
    • Creating your account
    • Platform Keys vs. BYOK
    • Understanding the Runtype UI
    • Quickstart: Social Media Post Generator
    • Quickstart: From Agent to Chat Widget
  • Dashboard
    • What is the Dashboard?
    • Daily Executions
  • Playground
    • What is the Playground?
  • Products & Surfaces
    • What are Products?
    • What are Surfaces?
    • Creating a Product
    • Setting up a Chat Surface
    • Setting up an API Surface
    • Setting up an MCP Surface
    • Setting up an A2A Surface
    • Setting up a Slack Surface
  • Flows
    • What are Flows?
    • Creating and Editing Flows
    • Flow step types overview
    • Agent and Flow Templates
  • Agents
    • What are Agents?
    • Creating and configuring Agents
    • Agent tools
  • Records
    • What are Records?
    • Creating and managing records
  • Tools
    • What are Tools?
    • Built-in Tools
    • Creating custom tools
    • Creating external tools
  • Evals
    • What are Evals?
    • Running an Eval
  • Schedules
    • What are Schedules?
  • Logs
    • What are Logs?
  • Integrations
    • Connecting AI model providers
  • Settings
    • What's in Settings?
    • Available AI models
  • Troubleshooting & FAQ
    • FAQ
    • Rate Limits and Usage
    • Managing Runtype with Claude
Dashboard
LogoLogo
On this page
  • Built-in tools
  • Custom tools
  • External tools
  • Flow tools
  • Runtime tools
  • MCP servers
  • How Agents use tools
  • Managing tools
  • Next steps
Tools

What are Tools?

Was this page helpful?
Previous

Built-in Tools

Next
Built with

Tools let your Agents and Flows take action — whether that means searching the web, calling an API, running custom code, or connecting to external services. Instead of only generating text, your AI can do work.

Runtype supports several tool types, so you can connect your workflows to almost anything they need.

Built-in tools

These ready-to-use tools are provided by Runtype. They appear automatically when you add tools to a prompt step or Agent and select a compatible model. For a deeper overview, see Built-in tools.

  • GPT Image 2 — Generate images from text descriptions
  • Exa — Search the web using neural or semantic search
  • Firecrawl — Scrape and extract structured data from websites
  • OpenAI Web Search — Search the web using OpenAI’s search capabilities
  • Anthropic Web Search — Search the web using Anthropic’s search capabilities
  • Anthropic Web Fetch — Fetch and extract content from any URL
  • Semantic Search — Search your knowledge bases using vector similarity

Firecrawl and Exa API keys are configured under Settings → Integrations. For GPT Image 2 and other provider tools, set up the provider under Settings → Models. Semantic Search works with any knowledge base you have created in the platform, with no extra setup.

Custom tools

Custom tools let you write JavaScript, TypeScript, or Python code for specialized tasks. They run in Runtype’s sandboxed environment and include built-in helper functions for text processing, date handling, validation, and encoding.

Great for: Data transformations, calculations, input validation, formatting, and business logic.

Custom tools include helpers like parseHTML(), extractEmails(), and formatDate(), so you do not need to build everything from scratch.

External tools

External tools connect your Agents and Flows to any HTTP API endpoint. They support multiple authentication methods, including Bearer tokens, API keys, and custom headers.

Great for: Third-party APIs, internal microservices, databases, webhooks, and legacy systems.

Flow tools

Flow tools let you turn any Flow into a reusable tool that other Agents and Flows can call. This is a powerful way to compose multi-step workflows and reuse them across your projects.

Great for: Multi-step operations, orchestrated tasks, and reusable workflows that you want to share across multiple Agents.

If you keep rebuilding the same logic in multiple Flows, extract it into its own Flow and use it as a Flow tool instead.

Runtime tools

Runtime tools are defined inline with API requests, such as when you call the dispatch API, without saving them to the platform first. They support the same types as saved tools: external HTTP, custom code, Flow, and subagent.

Great for: Dynamic or temporary tool configurations, SDK-driven Flows, testing, or cases where you do not want to store tool definitions in the platform.

MCP servers

You can connect MCP (Model Context Protocol) servers to expose additional tools to your Agents and Flows. MCP gives AI models a standard way to interact with external services, and Runtype can connect to any MCP-compatible server by URL with automatic tool discovery. To use MCP with a Product, see Setting Up an MCP Surface.

Great for: Extending your Agents with standardized integrations, connecting to internal tools, and using the growing MCP ecosystem.

How Agents use tools

When you add tools to an Agent, the AI decides when and how to use them.

  1. The Agent reads each tool description and understands what it can do.
  2. Based on the current task, the Agent decides which tool, if any, would help.
  3. The Agent generates the right parameters and calls the tool.
  4. The tool runs and returns results.
  5. The Agent uses the results and continues working.

This happens automatically. Your job is to make the right tools available and write clear descriptions so the Agent knows when to use each one. If you are setting up an Agent from scratch, see Creating and configuring Agents.

Good tool descriptions improve results. Be specific about what the tool does and when the Agent should use it.

Managing tools

You can create and manage saved tools from the Tools section in the sidebar.

  1. Click Tools in the sidebar to see your saved custom, external, and Flow tools.
  2. Click Create Tool to add a new tool, choose its type, and configure it.
  3. Open any existing tool to edit its settings, update its description, or adjust its parameters.

Built-in tools do not appear here. They become available when you configure them in Settings and add tools to an Agent or Flow step.

Next steps

  • Built-in tools — Learn more about using Exa, Firecrawl, GPT Image 2, and Semantic Search
  • What are Agents? — Understand how Agents decide when to use tools
  • Creating and configuring Agents — Add tools while setting up an Agent
  • Setting Up an MCP Surface — Connect MCP servers through a Product Surface