Pull your reports over API & MCP

Ecommerce Leads gives you problem-based store matches with decision-maker contacts. On the Growth plan you can read your own reports as JSON, or connect Claude and ChatGPT to them over the Model Context Protocol (MCP).

API and MCP access are on the Growth plan. You get one static API key. Ask for your key, then use it for both the API and MCP.

Authentication

Every request uses a static key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

To get a key, book a demo or request Diogo.

HTTP API

Two GET endpoints. Both return JSON.

List your reports

GET /api/reports — the reports that belong to your key, newest first.

curl https://getecommerceleads.com/api/reports \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response (redacted):

{
  "reports": [
    { "identifier": "AbCdEf1234567890", "title": "Acme Agency | Report #2", "date": "27/Aug/26" },
    { "identifier": "GhIjKl9876543210", "title": "Acme Agency | Report #1", "date": "20/Aug/26" }
  ]
}

Fetch one report (full)

GET /api/reports/{identifier} — one report as full JSON, including 24-month metric timelines.

curl https://getecommerceleads.com/api/reports/AbCdEf1234567890 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response shape (redacted — the exact fields depend on your report):

{
  "reportTitle": "Acme Agency | Report #2",
  "reportDate": "27/Aug/26",
  "records": [
    {
      "Name": "Example Store",
      "Domain": "example-store.com",
      "Industry": "Apparel",
      "Total Traffic": { "2025-09": 12345, "2025-10": 13890 }
    }
  ]
}

Field names above are illustrative; actual records carry the columns present in your report. Metric columns (traffic, spend, followers) are returned as {"YYYY-MM": value} maps.

MCP

Connect the same key over remote MCP at https://getecommerceleads.com/api/mcp. Three tools are exposed:

listReports — list your reports (identifier, title, date).
getReportBasic — one report's non-metric fields (identity, problem text, contacts). No traffic/spend/follower numbers.
getReportFull — one report's full JSON, with 24-month metric timelines.

Cursor

Add this to your mcp.json:

{
  "mcpServers": {
    "ecommerce-leads": {
      "url": "https://getecommerceleads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Add the server with a command, or use a JSON entry with "type": "http":

claude mcp add --transport http ecommerce-leads \
  https://getecommerceleads.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "ecommerce-leads": {
      "type": "http",
      "url": "https://getecommerceleads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Get your key

API and MCP access are on the Growth plan. Book a demo and we will issue your key.

Book a demo See pricing