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

# Levanta MCP for Sellers

> Connect Claude and Open AI assistants to your Levanta data through the Model Context Protocol.

Levanta MCP for Sellers lets AI assistants such as Claude and ChatGPT securely access your Levanta data — brands, creators,
products, and performance reports — so you can ask questions and build reports
in natural language.

## What is Levanta MCP for Sellers?

* For Levanta Sellers only
* A hosted MCP connection that gives your AI assistant tool-based access to
  your Levanta brands, creators, products, and performance reports.
* Authenticated via **OAuth**, so you sign in with your existing Levanta account
  and the assistant only gets access to data your account can already see.
* Accessible from any AI tool that supports remote MCP connections.

**MCP URL:**

```
https://app.levanta.io/api/mcp
```

## Quick start

<CardGroup cols={2}>
  <Card title="Claude" icon="https://mintcdn.com/levanta/TfSrZ6LA6QjNqV3k/icons/claude.svg?fit=max&auto=format&n=TfSrZ6LA6QjNqV3k&q=85&s=71cd672811174ac58f7b3c0d44810bb1" href="#claude" width="24" height="24" data-path="icons/claude.svg">
    See instructions
  </Card>

  <Card title="ChatGPT" icon="https://mintcdn.com/levanta/TfSrZ6LA6QjNqV3k/icons/chatgpt.svg?fit=max&auto=format&n=TfSrZ6LA6QjNqV3k&q=85&s=0f4dcf8d56952102df6decc981e13433" href="#chatgpt" width="24" height="24" data-path="icons/chatgpt.svg">
    See instructions
  </Card>
</CardGroup>

## Authentication

Levanta MCP for Sellers uses **OAuth**, so you authorize access to your Levanta
account directly from your MCP client.

* Each client (for example, Claude or ChatGPT) registers as an OAuth application
  with Levanta.
* When you connect Levanta MCP for Sellers, you're redirected to Levanta to sign in and
  grant access.
* No API key or token configuration is required.

<Note>
  Levanta MCP respects your team membership and role. You can only access the brands, creators, products, and reports
  your Levanta account already has permission to view.
</Note>

## Installation instructions

### Claude

You can add Levanta as a custom connector:

1. Navigate to **Settings > Connectors**.
2. Click **Add custom connector**.
3. Enter the Levanta MCP URL: `https://app.levanta.io/api/mcp`
4. Click **Add** to save the connector.
5. Follow the prompts to authenticate with your Levanta account.

To use the connector in a conversation:

1. Click the **+** button in your chat interface.
2. Select **Connectors**.
3. Toggle the Levanta connector on for that conversation.

<Note>
  Custom connectors using remote MCP are not available on all Claude plans. See the [Claude support
  page](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp) for
  more information.
</Note>

### ChatGPT

ChatGPT connects to custom MCP apps through **developer mode**. You'll first
enable developer mode, then create an app pointing at Levanta MCP for Sellers.

1. Enable developer mode: go to **Settings → Apps → Advanced settings → Developer mode**.
2. Open ChatGPT **Apps** settings and, next to **Advanced settings**, click **Create app**.
   (The **Create app** button only appears while developer mode is enabled.)
3. Enter a name (for example, "Levanta") and the Levanta MCP URL: `https://app.levanta.io/api/mcp`
4. Set the authentication method to **OAuth**, then create the app and follow the
   prompts to sign in to your Levanta account.
5. Your new app appears under **Drafts** in the app settings. Open its details
   page to toggle the available tools on.

To use it in a conversation, choose **Developer mode** from the **+** menu in the
composer and select the Levanta app for that conversation.

<Note>
  Developer mode is available to Pro, Plus, Business, Enterprise, and Education accounts on the web. It grants full
  MCP client access, so review write actions carefully before confirming them. See the [ChatGPT developer mode
  docs](https://developers.openai.com/api/docs/guides/developer-mode) for details.
</Note>

## Example workflows

Once connected, you can ask your MCP-enabled assistant to:

* "List all of my brands on Levanta."
* "Show me the creators currently partnered with my brand."
* "Find my top products by commission rate this month."
* "Summarize my seller performance totals for the last 30 days."
* "Which creators are driving the most sales for my brand?"
* "Build a product performance report and highlight my best ROAS products."

## Available tools

Levanta MCP for Sellers includes a curated set of read-only tools for exploring
your account and pulling performance reports.

| Tool                                   | Description                                                                                                                                                          |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `whoami`                               | Returns the authenticated Levanta user and team information.                                                                                                         |
| `seller_list_brands`                   | Lists brands for the authenticated seller team.                                                                                                                      |
| `seller_list_creators`                 | Lists creators with active partnerships for the authenticated seller team.                                                                                           |
| `seller_list_products`                 | Lists products for a seller brand, including product identifiers, marketplace, commission, availability, and status.                                                 |
| `seller_get_performance_report_totals` | Returns total seller performance report metrics across the full filtered dataset.                                                                                    |
| `seller_product_report`                | Lists seller product performance report rows aggregated by product, including sales, commission, ROAS, conversion, click, detail page view, and add-to-cart metrics. |
| `seller_creator_report`                | Lists seller creator performance report rows aggregated by creator, including sales, commission, ROAS, conversion, click, detail page view, and add-to-cart metrics. |
| `knowledge_base`                       | Returns the public Levanta knowledge base articles.                                                                                                                  |

<Note>
  All MCP date and datetime inputs are interpreted in UTC. When you ask for relative ranges like "today", "yesterday",
  or "last 7 days", they resolve using UTC calendar boundaries.
</Note>

## Troubleshooting

If your MCP client cannot connect or tools fail to run:

<AccordionGroup>
  <Accordion title="Restart your client or CLI tool">
    After installation, you may need to restart your client or CLI tool to load the new MCP configuration.
  </Accordion>

  <Accordion title="Check the connection URL">
    Make sure the Levanta MCP URL is set to `https://app.levanta.io/api/mcp`.
  </Accordion>

  <Accordion title="Re-authenticate Levanta MCP">
    Access tokens are short-lived. If your session has expired, re-authorize Levanta MCP in your client so it can
    request fresh tokens. Most MCP clients provide a way to re-authenticate MCP connections.
  </Accordion>

  <Accordion title="Verify your account access">
    Confirm that your Levanta account has access to the brands and data you expect to see. Levanta MCP can only
    access what your account can.
  </Accordion>
</AccordionGroup>

## Need help?

Reach out to our team through [Levanta Support](mailto:cs@levanta.io).