tough-tongue/toughtongue-skills / skills/ttai-agent
ttai-agent
VerifiedCreates, edits, and refines Tough Tongue AI Scenarios, the definitions behind voice agents (sales calls, lead qualification, demos, screening, support, booking) and practice roleplays (negotiations, interviews, coaching). Writes ai_instructions, ai_model_config, strategy, tools_config, and rubrik through ttai:create_scenario and ttai:update_scenario. Also resolves the personal or organization workspace, checks plan and balance, places or cancels SIP calls, schedules or cancels meeting bots, mints private Scenario links, grounds a Scenario in the user's documents with knowledge FileBases, and troubleshoots ttai MCP sign-in. Use when the user wants a voice agent or practice Scenario created or improved ("create a voice agent", "the agent ends calls too early", "make it sound more natural"), a call placed, a meeting bot sent, or a Tough Tongue AI account question answered. Not for reports across many sessions (ttai-session-analyst) or browser demo steps (ttai-browser-demo-builder).
references/mcp/clients.md
View on GitHub# Connect a client
Per-client registration of the hosted `ttai` MCP server. Plugin installs do this
automatically — use this file for manual, SSH, and web setups, and for auth
errors. Tools appear as `ttai:…` (some clients: `mcp__ttai__…`). If they are
missing, the server is not registered: fix registration here; never fall back to
invented REST calls.
Server: `https://api.toughtongueai.com/api/public/mcp` (Streamable HTTP; no SSE,
no local process).
## Contents
- Auth: OAuth only
- Coding agents (Claude Code, Codex, Cursor, Copilot, Windsurf, Gemini CLI)
- Stdio-only clients (mcp-remote)
- Web connectors (claude.ai, ChatGPT)
- Troubleshooting and FAQ
## Auth
Register the URL with no credentials. The client runs the OAuth 2.1 flow and
opens a browser consent page on first use (sign in at
[app.toughtongueai.com](https://app.toughtongueai.com) first). Revoke access at
[app.toughtongueai.com/developer](https://app.toughtongueai.com/developer).
- **No local browser (Claude Code over SSH)** — plugin install:
`claude mcp login plugin:toughtongue:ttai --no-browser` (check the name with
`claude mcp list`); manual install: `claude mcp login ttai --no-browser`. It
prints a URL: open it on your local machine, then paste the redirect URL from
the browser's address bar back at that command's prompt. Needs an
interactive terminal (`ssh -t`); not for CI or `claude -p`.
- **CI, servers, webhook pipelines, or a client without MCP OAuth** — send the
user to [headless setup](https://app.toughtongueai.com/docs/mcp/mcp-server#authentication)
in the Tough Tongue AI docs. Don't set up sign-in yourself.
## Coding agents
<details>
<summary>Claude Code</summary>
```bash
claude mcp add --transport http ttai https://api.toughtongueai.com/api/public/mcp
```
Run `/mcp` in a session and finish the browser login. (Plugin installs list
the server as `plugin:toughtongue:ttai`.)
</details>
<details>
<summary>Codex</summary>
```bash
codex mcp add ttai --url https://api.toughtongueai.com/api/public/mcp
codex mcp login ttai
```
Or in `~/.codex/config.toml`:
```toml
[mcp_servers.ttai]
url = "https://api.toughtongueai.com/api/public/mcp"
```
</details>
<details>
<summary>Cursor</summary>
[**Install in Cursor**](cursor://anysphere.cursor-deeplink/mcp/install?name=ttai&config=eyJ1cmwiOiJodHRwczovL2FwaS50b3VnaHRvbmd1ZWFpLmNvbS9hcGkvcHVibGljL21jcCJ9)
adds the server; Cursor prompts for OAuth on first use. The link's `config`
parameter is the JSON below, base64-encoded, and holds only the server URL.
Manual: **Cursor
Settings > MCP > Add new global MCP server**:
```json
{
"mcpServers": {
"ttai": { "url": "https://api.toughtongueai.com/api/public/mcp" }
}
}
```
</details>
<details>
<summary>GitHub Copilot (VS Code)</summary>
**MCP: Open User Configuration** (or `.vscode/mcp.json` per workspace):
```json
{
"servers": {
"ttai": {
"type": "http",
"url": "https://api.toughtongueai.com/api/public/mcp"
}
}
}
```
</details>
<details>
<summary>Windsurf</summary>
```json
{
"mcpServers": {
"ttai": {
"serverUrl": "https://api.toughtongueai.com/api/public/mcp"
}
}
}
```
Current Windsurf builds prompt for OAuth on first use; if yours doesn't, see
the headless setup page linked under Auth.
</details>
<details>
<summary>Gemini CLI</summary>
```json
{
"mcpServers": {
"ttai": {
"httpUrl": "https://api.toughtongueai.com/api/public/mcp"
}
}
}
```
Gemini CLI discovers OAuth on first connect; if no browser opens, run
`/mcp auth ttai`. It needs a local browser; otherwise see the headless setup
page linked under Auth.
</details>
## Stdio-only clients
Claude Desktop, Zed, and older VS Code bridge through
[mcp-remote](https://github.com/geelen/mcp-remote), which runs the OAuth flow
itself:
```json
{
"mcpServers": {
"ttai": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.toughtongueai.com/api/public/mcp"
]
}
}
}
```
Claude Desktop: **Settings > Developer > Edit Config**.
## Web connectors
Same OAuth flow, no config file.
<details>
<summary>claude.ai</summary>
1. **Settings > Connectors > Add custom connector**.
2. Name `Tough Tongue AI`, URL above. Leave OAuth Client ID and Secret empty
(dynamic client registration).
3. **Add**, approve on the consent page (signed in at the app first). The
connector shows **Connected**.
4. New chat, enable the connector, ask "List my Tough Tongue AI organizations."
</details>
<details>
<summary>ChatGPT (web only)</summary>
Simplest: install the official Tough Tongue AI app from the ChatGPT app
directory (no Developer mode). The steps below publish your own custom app.
Business, Enterprise, and Edu get full MCP including writes (beta); Pro is
read/fetch only.
1. Enable **Developer mode** (**Settings > Apps > Advanced settings**; on
Business only admins/owners, on Enterprise/Edu via **Permissions & Roles >
Connected Data**).
2. **Settings > Apps > Create**: MCP Server URL above, **OAuth**, **Scan
Tools**, complete consent, **Create**.
3. The app is a **Draft**; admins publish via **Workspace Settings > Apps >
Drafts > Publish**.
ChatGPT freezes the tool snapshot at approval; tool changes need an admin
refresh. Writes prompt for confirmation; deep research is read-only.
</details>
## Troubleshooting
- **Expected tool missing** — the client cached discovery. Start a new thread;
else remove and re-add the server.
- **401 / auth error** — finish OAuth: Claude Code `/mcp` (or
`claude mcp login <name>`: `plugin:toughtongue:ttai` or `ttai`), Codex
`codex mcp login ttai`, Cursor Settings > MCP, Gemini CLI `/mcp auth ttai`.
- **No browser at all (CI, server)** — link
[headless setup](https://app.toughtongueai.com/docs/mcp/mcp-server#authentication).
- **Edit not live in a call** — Scenario edits apply to new sessions only.
- **Works personally, not by org** — pass `org_id` from
`ttai:get_workspace_info` (`organizations[].id`).
- **mcp-remote internal error** — have the user clear mcp-remote's sign-in
cache (its README: delete the `~/.mcp-auth` folder, which signs out every
server mcp-remote holds), restart the client, and check Node is 18 or newer.
Don't delete files yourself.
- **Rate limited** — 30 calls/minute per token; wait, then retry; request only
the page you need.
Smoke test: `ttai:read_guide`, then
`ttai:get_workspace_info`.
## Key Files
- [tools.md](tools.md) — tool catalog and call conventions
- [../operating-model.md](../operating-model.md) — first-run orientation
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |