Getting Started

What is Spekta?

Spekta is a developer-first event intelligence platform that aggregates data from 25 ticketing providers — Eventbrite, Weezevent, DICE, Ticketmaster, and more — into a single unified schema. Once connected, you can query your events, ticket sales, attendees, and revenue through the Model Context Protocol (MCP), letting any MCP-compatible AI client (Claude Desktop, Cursor, Gemini) answer plain-English questions against your live data. For non-MCP integrations, the same tools are exposed as REST endpoints so you can wire them into ChatGPT Custom Actions, n8n workflows, or your own backend.

Quick Start: Connect Eventbrite in 5 minutes

Prerequisites

  • A Spekta account (free at spekta.io)
  • An Eventbrite account with at least one event

Steps

1. Create an Eventbrite OAuth app

  1. Go to eventbrite.com/account-settings/apps and click Create a new app.
  2. Set Application URL to https://spekta.io and OAuth Redirect URI to https://spekta.io/oauth/callback/eventbrite.
  3. Copy the Client ID and Client Secret.

2. Connect in Spekta

  1. Log in to Spekta and navigate to Providers.
  2. Find Eventbrite and click Connect.
  3. Paste your Client ID and Client Secret, then click Authorise.
  4. You will be redirected to Eventbrite to approve access. Accept the scopes.

3. Trigger the first sync

POST /api/sync/eventbrite
Authorization: Bearer <your-spekta-api-key>

Or click Sync Now in the Providers UI. The sync runs in the background and takes 10–90 seconds depending on the number of events.

4. Verify

GET /api/sync/status
Authorization: Bearer <your-spekta-api-key>

When status is "synced", your data is ready.

Tip: Spekta automatically refreshes OAuth tokens before they expire. You only need to re-authorise if you revoke access from Eventbrite's side.

Quick Start: Query your data via MCP in Claude Desktop

Prerequisites

  • Claude Desktop installed
  • A Spekta API key — generate one at Settings → API Keys

Steps

1. Open Claude Desktop configuration

On macOS:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows:

%APPDATA%\Claude\claude_desktop_config.json

2. Add the Spekta MCP server

{
  "mcpServers": {
    "spekta": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.spekta.io/mcp/sse"],
      "env": {
        "X-Spekta-API-Key": "tix_live_<your_key>"
      }
    }
  }
}

If you prefer a local MCP server, see the Self-hosting Guide.

3. Restart Claude Desktop

After saving the config, quit and relaunch Claude Desktop. You will see a hammer icon (🔨) in the chat toolbar — that confirms MCP tools are loaded.

4. Ask your first question

Which of my events had the highest ticket revenue last quarter?

Claude will call list_events and get_revenue automatically, then answer in plain English.

Available questions to try

  • "Compare ticket sales for my last three festivals."
  • "What's the conversion rate for VIP vs GA tickets at Summer Beats?"
  • "Show me a revenue breakdown by provider for 2025."
  • "Which provider has the most attendees registered for events in June?"

Quick Start: Use Spekta as a ChatGPT Custom Action

Spekta exposes a REST adapter at /tools/* that maps directly to the MCP tools, making it straightforward to wire into a ChatGPT Custom Action.

Steps

1. Open ChatGPT and create a new GPT

Go to chatgpt.com/gpts/editor and click Create a GPT.

2. Navigate to the Actions tab

Click Configure → Add Action.

3. Import the OpenAPI spec

Set the Schema URL to:

https://api.spekta.io/openapi.json

Click Import — all 6 endpoints will be loaded automatically.

4. Set authentication

Choose API Key as the authentication type, paste your Spekta API key, and set the header name to X-Spekta-API-Key.

5. Test

In the GPT preview, ask:

List my upcoming events.

The GPT will call POST /tools/list_events and return the results.

Note: The ChatGPT Custom Actions flow does not support SSE streaming; responses are always returned as a single JSON object.