> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wholana.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Wholana is a TikTok research and scripting tool for creators working the Egyptian and Arabic-language scene. The loop is: research the corpus, swipe what is worth reusing, write a script from those references, post, then audit the result.
> Use Wholana's shipped vocabulary exactly. The surfaces are Home (the explore feed, at /), Dashboard, Swipe file, Scripts, Your videos, Use cases, Creators, Subjects, and Craft. A Swipe is one saved corpus video plus the user's note; a Collection is a named group of Swipes inside the Swipe file; a Swipe in no Collection is Unfiled. A Lens is a saved filter-and-sort combination. A Subject is the topic taxonomy. Craft is the five-part vocabulary of hook archetypes, narrative structures, stake types, shareability drivers, and video formats. Baseline Multiple is a posted video's views divided by the creator's median views; Verdict is the derived Hit, Watch, Miss, or Pending call.
> Never use these retired terms: Idea, Save as idea, Saved ideas, Review ideas, Reference Angle, Craft Element, Suggestion, My videos, Track record, Category or Vertical as a filter name, or niche as a product term.
> Wholana MCP is the connector that brings a workspace into Claude, ChatGPT, or another MCP-capable chat app. It is included on Plus and Team only. It can search the corpus, read a video in full, read and edit existing scripts, pin references, save swipes into a Collection, and create Lens tabs. It cannot post to TikTok, delete anything, or create a new script.
> Answer only from these docs. Wholana has no public API, no SDK, no browser extension, no Instagram or YouTube support, and no scheduling or publishing. The MCP connector is not a public API: it is a plan-gated connection for chat apps, not something to build against. If the docs do not cover something, say so and point to contact@wholana.com rather than guessing.

# Wholana MCP

> Connect your Wholana workspace to Claude or ChatGPT on Plus and Team, then search the corpus, save swipes, and edit scripts by asking in plain language.

Wholana MCP puts your workspace inside the AI chat app you already use. Once it is connected, Claude or ChatGPT can search the TikTok corpus, read a video's craft breakdown and transcript, save swipes into a [Collection](/features/swipe-file#collections), pin references onto a [script](/features/scripts), and set up [Lens](/features/explore-feed#lenses) tabs for you.

You never write a filter, a query, or a line of code. You describe what you are after and the assistant does the looking.

## What you can ask for

Real requests that map to what the connector can actually do:

```text theme={null}
Find TikToks about morning routines that did at least 3x their creator's usual
views in the last 30 days, and save the best five to a collection called Hooks.
```

```text theme={null}
Pull up @egyptianfoodie's best video this month and read me its hook, beat
sheet, and transcript.
```

```text theme={null}
My script "Cairo traffic rant" needs a stronger opening. Read it, find three
videos that open the way I want, and pin them as references.
```

```text theme={null}
Set up a tab on Home for question-hook food videos posted in the last 60 days,
sorted by outlier score.
```

The assistant answers in the chat, and anything it saves shows up in Wholana straight away. There is no import step and no sync button.

## What you need

<Note>
  Wholana MCP is on **Plus** and **Team**. It is not included on Personal. See [Pricing](/pricing).
</Note>

* A workspace on Plus or Team. The plan belongs to the [workspace](/features/workspaces), not to you, so on Team every seat gets it.
* A chat app that can add a custom connector: Claude and ChatGPT both can.
* Nothing else. There is no token to generate, copy, or keep safe.

The plan is checked on every request, not only when you connect. If a workspace drops off Plus or Team, its existing connection stops working and the assistant tells you the workspace needs to upgrade.

## Connecting it

Open **MCP** in the Wholana sidebar. The **Server URL** field there is the one thing you need, with a **Copy** button next to it:

```text theme={null}
https://mcp.wholana.com/mcp
```

<Tabs>
  <Tab title="Claude">
    <Steps>
      <Step title="Open your connectors">
        In Claude, desktop or claude.ai, go to **Settings → Connectors**.
      </Step>

      <Step title="Add a custom connector">
        Click **Add custom connector**.
      </Step>

      <Step title="Name it and paste the URL">
        Name it **Wholana** and paste the Server URL.
      </Step>

      <Step title="Connect and sign in">
        Click **Add**, then **Connect**. A Wholana window opens. Sign in and choose the workspace you want the connector to see.
      </Step>

      <Step title="Start asking">
        Wholana's tools now show up in your chat.
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    <Steps>
      <Step title="Open your connectors">
        In ChatGPT, chatgpt.com or the desktop app, go to **Settings → Connectors**.
      </Step>

      <Step title="Create a connector">
        Click **Create**.
      </Step>

      <Step title="Name it and paste the URL">
        Name it **Wholana** and paste the Server URL as the **MCP server URL**.
      </Step>

      <Step title="Connect and sign in">
        Save, then click **Connect**. A Wholana window opens. Sign in and choose the workspace you want the connector to see.
      </Step>

      <Step title="Turn it on in a chat">
        Open a new chat and turn Wholana on from the **+** menu.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Other apps">
    Any app that speaks MCP works, including Cursor and other developer tools. Point it at the Server URL. The first time it connects, it walks you through signing in to Wholana. There is no token to paste.
  </Tab>
</Tabs>

Signing in is the whole setup. The workspace you pick is remembered for that connection.

<Tip>
  To connect a different workspace, switch to it in Wholana first, then connect again from your chat app.
</Tip>

## What it can reach

| The assistant can          | What that means                                                                                                                                                                                                                                                                                          |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Search the corpus**      | Find videos by wording in the caption, by creator handle, by [Subject](/subjects), by any [craft](/craft) label, by views, likes, comments, shares, their rates, follower count, [outlier score](/features/explore-feed#outlier-score), and by when they were posted. The same filters as the Home feed. |
| **Read one video in full** | The whole craft roll-up across the five systems, the beat sheet, the logline, and the cleaned transcript. The transcript is only available here, not anywhere in the app.                                                                                                                                |
| **Read your scripts**      | List the board, or open one script's full text along with every pinned reference, its note, and that reference's craft summary.                                                                                                                                                                          |
| **Edit a script**          | Rewrite the title, replace the body, or move it between **Draft**, **Ready**, and **Posted**.                                                                                                                                                                                                            |
| **Pin references**         | Attach corpus videos to a script, each with a note on why it is there.                                                                                                                                                                                                                                   |
| **Save swipes**            | Add videos to a Collection in your [Swipe file](/features/swipe-file), creating the Collection if it does not exist yet.                                                                                                                                                                                 |
| **Set up Lens tabs**       | Add saved [Lens](/features/explore-feed#lenses) tabs to Home or [Creators](/features/creators), up to twenty at a time.                                                                                                                                                                                  |

Two more things sit in the background, so the assistant does not have to guess: the full craft vocabulary with every valid label, and your workspace's profile, meaning the TikTok handle it is linked to, its Subjects, and a summary of your brand voice. It reads both without being asked.

## What it cannot do

Being clear about the edges saves you a frustrating conversation with your assistant.

* **It cannot post, schedule, or publish anything.** Wholana stops where TikTok starts, connector or not.
* **It cannot delete anything.** There is no tool for removing a script, a swipe, a Collection, or a Lens. Do that in the app.
* **It cannot start a new script.** It edits scripts that already exist. Create the script in Wholana or through the [WhatsApp bot](/features/whatsapp), then hand it to your assistant.
* **It cannot write your swipe notes.** Videos it saves land with an empty note, the same as any other swipe. The note stays yours.
* **Its text search matches the caption, not the transcript.** It is a plain wording match, not the semantic search the app's search palette runs. If a video is not coming back, filter by creator or by craft label instead of by wording.
* **It cannot look up your own posted-video track record.** Read that on [Your videos](/features/your-videos).
* **It sees one workspace.** The one you chose when you connected, and only for as long as you are still a member of it.
* **It sees the same corpus the app does**, which refreshes daily. A video posted an hour ago is not in it.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The assistant says the workspace needs Plus or Team">
    The workspace behind the connection is not on a plan that includes Wholana MCP, or it was on one and has since been downgraded. The check runs on every request, so an old connection stops working the moment the plan changes. Upgrade from **Settings → Billing**, then connect again from your chat app.
  </Accordion>

  <Accordion title="It is showing the wrong workspace's scripts and swipes">
    The workspace is locked in when you connect, not read live. Switch to the workspace you want in Wholana, then reconnect from your chat app. Reconnecting while signed in with the right workspace active repoints it.
  </Accordion>

  <Accordion title="It stopped working after I left a team">
    Leaving a workspace revokes the connector's access to it immediately, even though the connection still exists in your chat app. Connect again against a workspace you belong to.
  </Accordion>

  <Accordion title="Nothing happens when I click Connect">
    The Wholana window needs you signed in to Wholana in the same browser. Open [app.wholana.com](https://app.wholana.com), sign in, then start the connection again from your chat app.
  </Accordion>

  <Accordion title="It says a video or collection is not in my workspace">
    The connector only ever touches your own workspace's scripts, Collections, and Lenses. It says the same thing whether the item belongs to someone else or does not exist, on purpose. Check the name in the app.
  </Accordion>

  <Accordion title="It saved fewer videos than I asked for">
    Saving is deliberately forgiving. A video already in the Collection is skipped rather than duplicated, and a Lens whose name is already taken on that surface is skipped rather than overwritten. Running the same request twice is safe.
  </Accordion>
</AccordionGroup>

Still stuck? Mail [contact@wholana.com](mailto:contact@wholana.com) and say which chat app you are using.

## Related

<Columns cols={2}>
  <Card title="Pricing" icon="credit-card" href="/pricing">
    Which plans include Wholana MCP.
  </Card>

  <Card title="WhatsApp" icon="whatsapp" href="/features/whatsapp">
    The other way to use Wholana without opening it.
  </Card>

  <Card title="Scripts" icon="file-pen" href="/features/scripts">
    The board the connector edits.
  </Card>

  <Card title="Limits" icon="circle-info" href="/not-available">
    What Wholana doesn't do.
  </Card>
</Columns>