# Soontra MCP server

Connect an AI app or your own code to a Soontra workspace: search files, read transcripts and results, and leave drafts for a person to approve.

Soontra runs a remote server that speaks the [Model Context Protocol](https://modelcontextprotocol.io) (MCP). Any MCP client can use it: ChatGPT, Claude, Gemini, Grok, Perplexity, Cursor, VS Code, Claude Code, or a script you write. There is one endpoint:

Endpoint:

```
https://app.soontra.com/api/mcp
```

> **Note:** This server is Soontra’s API. There is no separate REST API or webhook surface for the same data. If you want to call Soontra from code, you call this endpoint (see [Call it from code](https://soontra.com/docs/call-from-code)).

## What a connected app can do

- **Search** the workspace by what was said or shown in a video, by text on a page, or by file name.
- **Read** file details, transcripts, scene descriptions, document text, projects, comments, posts and notifications.
- **See results**: views, likes and comments for connected YouTube, Instagram and TikTok accounts.
- **Write drafts**: create and edit projects, subtasks, comments, documents, folders and post drafts, and upload files.
- **Show media in the chat**: in apps that support interactive views, play a video at the moment that matched.

## What it can never do

- **Publish or schedule a post.** A connected app leaves a draft. A person sends it from Soontra.
- **Delete anything.** No credential can be granted deletion.
- Read or edit spreadsheets, open the content behind a saved link, create share links, or generate or edit media.

What a given connection can do is narrower still: it is limited to the [scopes](https://soontra.com/docs/scopes) chosen when it was set up.

## Who can connect

Workspace owners and admins. They connect an AI app by signing in, or create API keys for tools and scripts, under **Settings**, **API & MCP** in Soontra. See [Authentication](https://soontra.com/docs/authentication).

## Where to start

- [Quickstart](https://soontra.com/docs/quickstart): Connect an app and run a first prompt in a few minutes.
- [Connect an AI app](https://soontra.com/docs/connect): Step-by-step setup for nine apps and editors.
- [Tool reference](https://soontra.com/docs/tools): Every tool, its parameters and what it returns.
- [Call it from code](https://soontra.com/docs/call-from-code): Use the endpoint from curl, TypeScript or Python.