SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate TinyFish MCP with Codex

Connect Codex to TinyFish MCP. Summarize top hacker news stories, check pricing on competitor websites, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
TinyFish MCP logoTinyFish MCP
Dcr Oauth

TinyFish MCP is an AI-powered browser automation service for browsing, clicking, extracting, and interacting with websites. Use it to run reliable web tasks without hand-writing fragile browser scripts.

20 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With TinyFish MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Also integrate TinyFish MCP with

Claude Cowork

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1500+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install TinyFish MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

What is the TinyFish MCP server, and what's possible with it?

The TinyFish MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your TinyFish MCP account. It provides structured and secure access to live web content, browser automations, sessions, monitors, and account usage, so your agent can search the web, fetch page content, run and inspect automations, monitor changes, and review usage on your behalf.

  • Live web research: Have your agent search the web for current information and fetch content from one or more URLs with source details.
  • Browser automation: Direct your agent to click through dynamic pages, complete forms, handle login flows, check progress, and cancel runs when requested.
  • Automation review: Let the agent inspect completed automation steps, find recent runs, and diagnose runs that timed out or returned errors.
  • Browser sessions and monitoring: Instruct your agent to open, list, or close remote browser sessions and monitor webpages or web topics for updates.
  • Usage and wallet checks: Have your agent review search and fetch history, audit usage, and check your TinyFish wallet status.

Conclusion

You've successfully integrated TinyFish with Codex using Composio's MCP server. Now you can interact with TinyFish directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for TinyFish operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1500+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various TinyFish operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every TinyFish MCP action and event your agent gets out of the box.

Batch cancel

Only use when the user explicitly asks to stop multiple running or pending automations.

Batch status

Only use after batch_create to poll progress for multiple automation runs.

Cancel run

Only use when the user explicitly asks to stop a running or pending automation.

Close browser session

Only use when the user explicitly wants to stop or close a remote browser session.

Create browser session

For direct browser control or visual QA, open a browser session through your wallet account.

Create monitor

Use when the user asks to monitor a webpage for changes or subscribe to updates about a web topic.

Discover run

App-only tool for discovering the currently running automation for this session.

Fetch content

Default, free, and most token-efficient tool for reading URL(s) and extracting source details.

Get run

Only use after run_web_automation errors, times out, or returns a run_id that needs polling.

Get search usage

Only use when the user asks to review search history, check what queries were made, or audit usage.

Get steps

Only use when the user asks to inspect how an automation ran.

Get wallet

Read-only.

Guide next step

Returns the next interactive TinyFish onboarding step based on the user’s real usage.

List browser sessions

Only use when the user asks to check active browser sessions, review browser usage history, or find a specific browser session by ID.

List fetch usage

Only use when the user asks to review fetch history or audit fetch usage.

List runs

Only use when you need to find a run_id for a recently created automation, usually after run_web_automation timed out before returning one.

Poll status

App-only tool for polling the current status of an automation run.

Run web automation

Metered web automation is available through your wallet — use it for clicking, forms, login, or dynamic pages.

Run web automation async

⚠️ ONLY call this tool when the user has EXPLICITLY said they want to run the task in the background (e.

Search

Default, free, and most token-efficient first tool for external knowledge and web grounding.

FRAMEWORKS

How to build TinyFish MCP Agent with another framework

Claude Cowork logo

Claude Cowork

Use TinyFish MCP with Claude Cowork

FAQ

Frequently asked questions

With a standalone TinyFish MCP server, the agents and LLMs can only access a fixed set of TinyFish tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from TinyFish and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Codex fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right TinyFish tools.

Yes, absolutely. You can configure which TinyFish scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your TinyFish data and credentials are handled as safely as possible.

Start with TinyFish MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every TinyFish MCP tool your agent needs.Free to start.

Start building