PlugsightDocs

Developer API

Use the same live data your AI sees in your own website, dashboard or system, over plain HTTPS and JSON. Pro and Agency plans.

The developer API lets your own code use the accounts you've connected to Plugsight: Google Analytics, Google Ads, Search Console, Zendesk, your mailbox, your store, your calendar and the rest. You connect each account once in the app. You never build OAuth apps, store tokens or learn each provider's API.

It runs the same tools your AI app uses, with the same rules. Your code sends an HTTPS request with a key, Plugsight reads the data live from the provider, and you get JSON back.

The developer API is on the Pro and Agency plans. On Free, every request is refused with 403 plan_required.

How it works

  1. Connect your accounts under Connections in the app.
  2. Choose what the key can reach. An MCP server is your API project: it groups the accounts one key may use.
  3. Create the API key on the MCP server's page.
  4. Call a tool by name, such as get_marketing_data, and get its data back.

There's nothing to install and no SDK. Any language that can send an HTTPS request works.

Words used in these articles

Word What it means
Connection An account you've linked, such as a Google Ads account or a Zendesk helpdesk. You add them under Connections.
MCP server A named group of connections with its own key. AI apps like Claude and ChatGPT use the same thing, which is why the app calls it an MCP server. For the API, think of it as a project. Make one per website or system, so each key reaches only what it needs.
API key The secret that identifies your MCP server. It starts with mcpk_. Each MCP server has at most one key.
Tool One thing the API can do, like "search Zendesk tickets" or "get Google Ads spend by campaign". Each has a name, arguments and an answer.
Read and Change Read tools only fetch data. Change tools do something, such as send an email or update a ticket, and need extra permission.

Quick start

About five minutes.

  1. Open Connections and connect an account, for example Google Analytics.
  2. Open MCP servers and click Create MCP server. Name it after where you'll use it, for example "Company website".
  3. Under Account access, choose Selected accounts and tick only the accounts this key should reach.
  4. Untick Allow changes if the key only needs to read.
  5. On the MCP server's page, find API key and click Create API key.
  6. Copy the key straight away. It's shown only once.
  7. Save it as an environment variable on your server:
export PLUGSIGHT_API_KEY="mcpk_…"
  1. List the tools the key can use:
curl https://app.plugsight.app/v1/tools \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY"
  1. Find your account ids:
curl -X POST https://app.plugsight.app/v1/tools/list_accounts \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" -d '{}'
  1. Get real data, for example the last 30 days of website sessions by day:
curl -X POST https://app.plugsight.app/v1/tools/get_marketing_data \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"connector": "analytics", "fields": ["date", "sessions", "users"], "date_preset": "last_30d"}'

Same rules as your AI app

The API uses the MCP server's tools exactly as an AI app does, so everything you've set in the app applies:

  • Which accounts: only the MCP server's accounts, minus any sites, properties or ad accounts you've hidden.
  • Which tools: the tools follow the connections. Add Zendesk to the MCP server and the Zendesk tools appear; remove it and they go.
  • Your plan: your plan's limits and features apply. Marketing and analytics data needs Pro or Agency.
  • Changes: change tools need "confirm": true, Allow changes on the MCP server, the account's switch on, nothing paused on Permissions, and the daily email limit not reached.
  • Activity: every call appears in Activity in the app, as "Developer API".

Limits

  • Up to 120 requests a minute per MCP server. Over that, you get 429 rate_limited. Need more? Use a second MCP server, or cache results on your side.
  • Providers' own limits still apply (Google Ads, Zendesk and so on). When a provider says "slow down", the tool returns an error saying so.
  • Data is read live on every call. Plugsight caches and stores nothing, so cache results yourself if you show them often.

In this section