Skip to content
Panelia
MCP connector

Plug your AI agent into Panelia

Launch a synthetic market study from Claude, Cursor or any MCP-capable client, and get calibrated results without leaving your conversation. Nothing to install: one URL is enough.

Model Context Protocol is the open standard that connects an AI assistant to your tools. Panelia plugs in with a single address, under an authorization you grant — and revoke — from your dashboard. Included in every plan, starting with Free.

Connecting

The connector is hosted by Panelia. There is no package to install, no file to build, no key to copy: your MCP client works out how to authenticate on its own.

Connector address
https://www.panelia.io/api/mcp
  1. 01

    Paste the address

    Add this URL as a remote MCP server in your client.

  2. 02

    Sign in

    The client opens Panelia in your browser. You sign in as usual, just like on the site.

  3. 03

    Authorize

    You pick the organization and the permissions granted. You can remove some before confirming.

  4. 04

    Use it

    The agent now has the tools. The authorization stays revocable at any time from this page.

What the connector can do

Each tool runs inside Panelia, with your rights and your quotas — exactly as if you were acting from the interface.

  • panelia_list_panelsRead

    Lists the simulable markets and audience archetypes, with each market's real age domain.

  • panelia_create_studyWrite

    Creates and launches a study in one call. Reserves credits; accepts an idempotency key so a retry relaunches nothing.

  • panelia_list_studiesRead

    Lists the organization's studies, newest first, with their latest run's status.

  • panelia_get_studyRead

    Status and progress of a study. Results are included as soon as the run completes.

  • panelia_get_resultsRead

    Aggregates of the latest completed run: Likert distribution, confidence intervals, segments, drivers and barriers, verbatims.

  • panelia_export_resultsRead

    Full JSON export: the study definition and its complete report, for archiving or downstream analysis.

  • panelia_create_checkout_linkWrite

    Generates a Stripe payment link to top up credits or subscribe to a plan. Charges nothing by itself.

Typical flow

A study is asynchronous: nothing waits for the result inline. The agent launches, then polls.

  1. panelia_list_panels — pick a valid market
  2. panelia_create_study — immediate response: id, QUEUED status, credits reserved
  3. panelia_get_study — repeat until the status is COMPLETED
  4. panelia_get_results — read the aggregates, then export if needed
panelia_create_study
{
  "title": "Sérum Vitamine C",
  "type": "PRODUCT",
  "market": {
    "country": "FR",
    "audience": "representative"
  },
  "panelSize": 500,
  "engine": "standard",
  "concepts": [
    {
      "label": "A",
      "title": "Sérum Vit. C 30 ml",
      "description": "Concentré 15 %, flacon verre ambré",
      "price": 24.9,
      "category": "cosmétique"
    }
  ],
  "idempotencyKey": "serum-vitc-2026-08"
}

Declaring the connector

Depending on the client, the address goes in a configuration file or in a command. Either way, it contains no secret.

Claude Desktop and Cursor

Add the connector to your client's configuration.

claude_desktop_config.json
{
  "mcpServers": {
    "panelia": {
      "url": "https://www.panelia.io/api/mcp"
    }
  }
}

Claude Code

A single command is enough.

shell
claude mcp add --transport http panelia https://www.panelia.io/api/mcp

Cursor: same JSON structure, in .cursor/mcp.json at the project root.

Automatic discovery

Your client queries these addresses to work out how to authenticate. You should never need to type them.

https://www.panelia.io/.well-known/oauth-protected-resourcehttps://www.panelia.io/.well-known/oauth-authorization-server

What you authorize

When connecting, you pick the organization and the permissions granted. Each one can be unchecked.

  • studies:read

    Read your studies, their status and their results. Granted by default.

  • studies:write

    Create and launch studies. Consumes credits.

  • billing:manage

    Generate a payment link to top up credits or change plan. Charges nothing by itself.

Your role remains the limit

An authorization can never grant more than your role already allows. A viewer who authorizes writing still cannot launch a study: what applies is the intersection of the two, never one or the other.

Multilingual: two languages not to confuse

Interface language

The language of the connector's tool descriptions and error messages. It follows your Panelia profile language — nothing to configure client-side.

Study language

The language of the synthetic respondents. It follows from the simulated market, and from it alone: personas are named and answer in their market's language and culture.

Simulable markets

FRDEESITGBUSCA_ENCA_FR

Audience archetypes

representativemenwomenb2b

Security

  • OAuth 2.1 authorization

    The client never sees your password. You sign in on Panelia, and the token issued is bound to this connector and to nothing else.

  • No secret to handle

    There is no key to copy, no file to protect. Nothing sensitive sits in a configuration file.

  • Immediate revocation

    Removing an authorization cuts access that instant, without waiting for a token to expire.

  • One organization at a time

    A token is valid for the organization you picked at consent. It opens no other, even one you belong to.

  • Billed operations

    Launching a study consumes credits. The relevant tools are annotated so your client can ask for confirmation.

  • Plan quotas

    The connector applies exactly the same limits as the interface: credits, compared concepts, studies held. It opens no shortcut.

A market study, straight from your AI agent

Describe a concept, the agent launches the panel and comes back with a calibrated purchase-intent distribution.