Tools (MCP)

Added in v0.8 (Released on 2025-03-16), Status: Beta

LLMs can use tools implemented in the Model Context Protocol (MCP) to access external resources and perform actions.

Add a tool

You can add tools (MCP servers) in the settings:

INFO

MCP servers are long-running processes, if you turn on the switch on the top-right, the server will be started and will run in the background until you exit the app. If you made any changes to the configuration, the server will be automatically restarted too.

Here's a list of reference MCP servers by Anthropic:

https://github.com/modelcontextprotocol/servers#-reference-servers

For example with the git mcp server:

You can enable Auto-run if you think it's safe to run the tools provided by this server automatically without user confirmation.

Chat with tools

You can see a hammer icon below the input box:

Click the switch to enable tools for the chat and the assistant, click the tool id to select the tool.

Tool Types

Command Line MCP

MCP based on command line input/output (stdio).

Environment variables supported in commands:

• $HOME: User directory
• $TMPDIR: System temporary directory

SSE MCP

MCP based on network requests.

Import from JSON

Besides manually adding MCP servers, you can also import from JSON config from another app, for example Windsurf's mcp_config.json, the JSON should look like this:

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "fetch-mcp", "start"],
      "env": {
        "SOME_ENV": "SOME_VALUE"
      }
    }
  }
}

First copy your JSON config, and click the + icon in Tools settings and choose Import JSON from Clipboard:

If a server with the same id already exists, we will update it.

Known issues

• Not optimized to work with the built-in web search and Artifacts yet
• You may need a more capable model to run tools reliably
• GPT-4o and GPT-4o-mini might not be able to follow the instructions and use tools.
• Not optimized for Ollama yet
• Command not found error: by default we run the command on macOS using zsh, on Windows using cmd, if the command is not found, you can try using a full path to the command instead.
• Currently only handled tool results of text type, image type, and resource type with file:// uri.