touai-mcp

An MCP server that gives coding agents (Cursor, Claude Code, Codex, Claude Desktop, …) tools for the TouAI platform: web scraping and search, deep research with cited reports, document / video parsing, knowledge bases, connectors to databases and SaaS apps, object storage and billing.

It is a thin layer over the official Python SDK, touai. Credentials stay in the environment of the server process and never travel over the protocol.

Setup

1. Create a project API key: open the console at https://platform.tou.ai/, sign in, open your project, Project → API Keys, create a key. You get an access key id (ak_live_…) and a secret (sk_live_…, shown once).

2. Add the server to your client with uvx touai-mcp (needs uv) or pipx run touai-mcp, using one of the methods below.

One command (recommended)

touai-setup registers this server in every supported client on the machine (Cursor, Claude Code, Codex, Claude Desktop, Windsurf) and installs the TouAI Agent Skills as well. Run it yourself or paste it to your agent:

uvx touai-setup

If TOUAI_ACCESS_KEY_ID / TOUAI_SECRET_KEY are in your environment they are written into the config; otherwise it leaves placeholders and tells you to create a key pair in the console (Project → API Keys), export both, and run it again.

Let your agent do it

Paste this into Cursor, Claude Code or Codex:

Add the "touai" MCP server to my config: command `uvx`, args `["touai-mcp"]`,
env `TOUAI_ACCESS_KEY_ID` and `TOUAI_SECRET_KEY`. Leave the two values as placeholders;
I will fill them in myself. Then tell me where the config file is and remind me that the
key pair comes from the TouAI console under Project → API Keys.

The agent writes the entry and tells you where to get the key pair; you fill in the two values and restart the client. Never paste the secret into the chat.

Cursor — one click

Replace the two placeholder values with your key pair after installing.

Cursor — ~/.cursor/mcp.json (or .cursor/mcp.json in a project)

{
  "mcpServers": {
    "touai": {
      "command": "uvx",
      "args": ["touai-mcp"],
      "env": {
        "TOUAI_ACCESS_KEY_ID": "ak_live_...",
        "TOUAI_SECRET_KEY": "sk_live_..."
      }
    }
  }
}

Claude Code

claude mcp add touai -e TOUAI_ACCESS_KEY_ID=ak_live_... -e TOUAI_SECRET_KEY=sk_live_... -- uvx touai-mcp

Codex — ~/.codex/config.toml

[mcp_servers.touai]
command = "uvx"
args = ["touai-mcp"]
env = { TOUAI_ACCESS_KEY_ID = "ak_live_...", TOUAI_SECRET_KEY = "sk_live_..." }

Claude Desktop — claude_desktop_config.json

Same shape as the Cursor block under "mcpServers".

Optional environment: TOUAI_BASE_URL, TOUAI_TIMEOUT, TOUAI_MAX_RETRIES (see the SDK docs).

Related MCP server: jiro

Tools

Long-running tools (touai_research, touai_parse_document, touai_web_crawl) block up to timeout_seconds; on timeout they return the job id and the work continues server-side — call the matching *_status tool instead of re-submitting.

Development

uv venv && uv pip install -e ".[dev]"
# until `touai` is on PyPI, install the SDK from a sibling checkout first:
#   uv pip install ../touai-python
.venv/bin/pytest
TOUAI_ACCESS_KEY_ID=… TOUAI_SECRET_KEY=… .venv/bin/touai-mcp   # stdio; point your client at this command

While developing, point a client at the checkout's venv instead of uvx (uv run --directory … only works once touai resolves from PyPI):

{ "command": "/path/to/touai-mcp/.venv/bin/touai-mcp", "env": { … } }

Agent Skills

For agents that write Python against the SDK directly, see touai/touai-skills. The two are complementary: skills teach code, this server provides ready-made tools.

License

Apache-2.0