Skip to main content
The Levanta Seller MCP server 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 the Levanta MCP server?

  • A hosted MCP server that exposes your Levanta brands, creators, products, and performance reports as tools your AI assistant can call.
  • 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 MCP client that supports remote HTTP servers.
  • For Levanta Sellers only
Server URL: 
https://app.levanta.io/api/mcp

​
Quick start

https://mintcdn.com/levanta/TfSrZ6LA6QjNqV3k/icons/claude-code.svg?fit=max&auto=format&n=TfSrZ6LA6QjNqV3k&q=85&s=45bac033d1fb778bfe356051df544aec

Claude Code

See instructions
https://mintcdn.com/levanta/TfSrZ6LA6QjNqV3k/icons/claude.svg?fit=max&auto=format&n=TfSrZ6LA6QjNqV3k&q=85&s=71cd672811174ac58f7b3c0d44810bb1

Claude Desktop

See instructions
https://mintcdn.com/levanta/TfSrZ6LA6QjNqV3k/icons/chatgpt.svg?fit=max&auto=format&n=TfSrZ6LA6QjNqV3k&q=85&s=0f4dcf8d56952102df6decc981e13433

ChatGPT

See instructions
https://mintcdn.com/levanta/TfSrZ6LA6QjNqV3k/icons/codex.svg?fit=max&auto=format&n=TfSrZ6LA6QjNqV3k&q=85&s=cf466abd3c4a913d2a828e94c4806634

Codex

See instructions

​
Authentication

The hosted MCP server 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 the MCP server, you’re redirected to Levanta to sign in and grant access.
  • No API key or token configuration is required.
The MCP server respects your team membership and role. You can only access the brands, creators, products, and reports your Levanta account already has permission to view.

​
Installation instructions

​
Claude Code

  1. Ensure Claude Code is available in your terminal:
claude --version
  1. Add the Levanta MCP server:
claude mcp add --transport http "levanta" https://app.levanta.io/api/mcp
  1. Start Claude Code:
claude
  1. List the available MCP servers with the /mcp slash command:
/mcp
You should see the Levanta MCP server listed and needing authentication. Select it, press “Enter”, and follow the instructions in your browser to authenticate.

​
Claude Desktop and Claude.ai

You can add Levanta as a custom connector:
  1. Navigate to Settings > Connectors.
  2. Click Add custom connector.
  3. Enter the Levanta MCP server 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.
Custom connectors using remote MCP are not available on all Claude plans. See the Claude support page for more information.

​
ChatGPT

ChatGPT connects to custom MCP servers through developer mode. You’ll first enable developer mode, then create an app pointing at the Levanta MCP server.
  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 server 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.
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 for details.

​
Codex CLI

  1. Ensure Codex CLI is available in your terminal:
codex --version
  1. Add the Levanta MCP server:
codex mcp add levanta --url https://app.levanta.io/api/mcp
You should be prompted to authenticate. Follow the instructions in your browser to sign in to Levanta.
  1. Start Codex and list the available MCP servers with the /mcp slash command:
codex

/mcp
You should see the Levanta MCP server listed, enabled, and authenticated.

​
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

The Levanta MCP server includes a curated set of read-only tools for exploring your account and pulling performance reports.
ToolDescription
whoamiReturns the authenticated Levanta user and team information.
seller_list_brandsLists brands for the authenticated seller team.
seller_list_creatorsLists creators with active partnerships for the authenticated seller team.
seller_list_productsLists products for a seller brand, including product identifiers, marketplace, commission, availability, and status.
seller_get_performance_report_totalsReturns total seller performance report metrics across the full filtered dataset.
seller_product_reportLists seller product performance report rows aggregated by product, including sales, commission, ROAS, conversion, click, detail page view, and add-to-cart metrics.
seller_creator_reportLists seller creator performance report rows aggregated by creator, including sales, commission, ROAS, conversion, click, detail page view, and add-to-cart metrics.
knowledge_baseReturns the public Levanta knowledge base articles.
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.

​
Troubleshooting

If your MCP client cannot connect or tools fail to run:
After installation, you may need to restart your client or CLI tool to load the new MCP configuration.
Make sure the MCP server URL is set to https://app.levanta.io/api/mcp.
Access tokens are short-lived. If your session has expired, re-authorize the Levanta MCP server in your client so it can request fresh tokens. Most MCP clients provide a way to re-authenticate a server.
Confirm that your Levanta account has access to the brands and data you expect to see. The MCP server can only access what your account can.

​
Need help?

Reach out to our team through Levanta Support.