GingerLive

Official6 tools

by gingerlive-io · TypeScript

GingerLive livestream ad formats, network reach stats, campaign case studies, and streamer program.

io.gingerlive/mcp (Model Context Protocol) Server

The io.gingerlive/mcp MCP server provides access to GingerLive content related to livestream ad formats, network reach statistics, campaign case studies, and a streamer program. It is intended to expose this dataset through MCP tools, with a total of 6 tools available.

🛠️ Key Features

Livestream ad formats
Network reach stats
Campaign case studies
Streamer program
6 tools exposed via MCP

🚀 Use Cases

Retrieve GingerLive ad format details
Review network reach statistics
Inspect campaign case studies for performance context
Access information related to the streamer program

⚡ Developer Benefits

Centralizes GingerLive-related reference data behind MCP (6 tools)
Enables developer access to the provided categories (formats, stats, cases, program)

Topics

advertisingai-agentscloudflare-workersinfluencer-marketingkickmcpmcp-servermodel-context-protocoltwitchlivestream-advertising

Captured live from the server via tools/list.

get_company_overview

Returns GingerLive's company profile: what the livestream advertising platform does, supported streaming platforms (Twitch, Kick, YouTube Live, TikTok LIVE), reference clients, headline network stats, third-party measurement partners and contact links. Use first for general "what is GingerLive" questions; use get_network_stats for just the reach numbers, list_ad_formats for formats, get_streamer_program_info for the creator side. Read-only; data is a static snapshot of gingerlive.io's public facts.

Parameters1

intent

string

optional

Optional: one short sentence on what the user is trying to accomplish, e.g. 'compare ad formats for a gaming product launch in Turkey'. Used only to improve this server's coverage. Do not include names, emails or other personal data.

Raw schema

{
  "type": "object",
  "properties": {
    "intent": {
      "description": "Optional: one short sentence on what the user is trying to accomplish, e.g. 'compare ad formats for a gaming product launch in Turkey'. Used only to improve this server's coverage. Do not include names, emails or other personal data.",
      "type": "string",
      "maxLength": 300
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_network_stats

Returns GingerLive's network reach and performance figures: streamer count, annual unique reach, monthly hours of livestreams watched and ad view-through rate. Use when a user asks about scale or performance benchmarks; use list_case_studies for campaign-specific results. Read-only; figures are GingerLive's published network numbers.

Parameters1

intent

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "intent": {
      "description": "Optional: one short sentence on what the user is trying to accomplish, e.g. 'compare ad formats for a gaming product launch in Turkey'. Used only to improve this server's coverage. Do not include names, emails or other personal data.",
      "type": "string",
      "maxLength": 300
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_ad_formats

Lists the livestream ad formats GingerLive sells to brands (e.g. picture-in-picture, banners, rich media, pinned chat drops, streamer announcements), each with a short description, plus format badges such as unskippable and adblock-safe. Use when planning or comparing ad formats; use get_company_overview for the company itself. Read-only.

Parameters1

intent

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "intent": {
      "description": "Optional: one short sentence on what the user is trying to accomplish, e.g. 'compare ad formats for a gaming product launch in Turkey'. Used only to improve this server's coverage. Do not include names, emails or other personal data.",
      "type": "string",
      "maxLength": 300
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_case_studies

Lists GingerLive campaign case studies with slug, title, short excerpt and URL. Use to find proof points or results for a brand, category or format, then call get_case_study with a slug for the full write-up. Read-only.

Parameters1

intent

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "intent": {
      "description": "Optional: one short sentence on what the user is trying to accomplish, e.g. 'compare ad formats for a gaming product launch in Turkey'. Used only to improve this server's coverage. Do not include names, emails or other personal data.",
      "type": "string",
      "maxLength": 300
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_case_study

Returns one GingerLive campaign case study: title, date, URL and the full markdown write-up (brand, approach and results). Requires a slug from list_case_studies; an unknown slug returns the list of valid slugs. Read-only.

Parameters2

slug	string	required	Case-study slug, e.g. 'turknet-x-gingerlive-case-study-gen-z-livestream-advertising-campaign'
intent	string	optional	Optional: one short sentence on what the user is trying to accomplish, e.g. 'compare ad formats for a gaming product launch in Turkey'. Used only to improve this server's coverage. Do not include names, emails or other personal data.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Case-study slug, e.g. 'turknet-x-gingerlive-case-study-gen-z-livestream-advertising-campaign'"
    },
    "intent": {
      "description": "Optional: one short sentence on what the user is trying to accomplish, e.g. 'compare ad formats for a gaming product launch in Turkey'. Used only to improve this server's coverage. Do not include names, emails or other personal data.",
      "type": "string",
      "maxLength": 300
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_streamer_program_info

Returns how livestreamers join and earn with GingerLive: cost (free for streamers), how the in-stream ad program works, supported platforms and the sign-up link. Use for creator or streamer monetization questions; for brand-side questions use get_company_overview or list_ad_formats instead. Read-only; public program information.

Parameters1

intent

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "intent": {
      "description": "Optional: one short sentence on what the user is trying to accomplish, e.g. 'compare ad formats for a gaming product launch in Turkey'. Used only to improve this server's coverage. Do not include names, emails or other personal data.",
      "type": "string",
      "maxLength": 300
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md5 KBView on GitHub

GingerLive MCP Server

The official Model Context Protocol server for GingerLive, the livestream advertising platform that connects brands with 1,000+ streamers on Twitch, Kick, YouTube Live and TikTok Live.

Connect it to Claude, ChatGPT, Cursor or any MCP client and your assistant can answer questions about livestream advertising using GingerLive's own up-to-date data: ad formats, network reach, campaign case studies and the streamer monetization program.

Endpoint (Streamable HTTP): https://mcp.gingerlive.io/mcp
Auth: none (public, read-only data)
Registry: io.gingerlive/mcp in the official MCP Registry
Docs: gingerlive.io/developers

What it can do

Tools

Tool	Returns
`get_company_overview`	What GingerLive is: positioning, streaming platforms, network stats, third-party measurement partners, contact links
`get_network_stats`	Network reach and performance: streamer count, annual unique reach, monthly hours watched, ad view-through rate
`list_ad_formats`	The livestream ad formats offered to brands, with descriptions and format badges (e.g. unskippable, adblock-safe)
`list_case_studies`	Campaign case studies, each with a short excerpt and link
`get_case_study`	The full write-up of one case study, by slug
`get_streamer_program_info`	How streamers join and earn: cost, how it works, supported platforms, sign-up link

Every tool also accepts an optional intent string: one sentence on what the user is trying to do, with no personal data. The hosted server logs each tool call (tool, arguments, intent, session id, client name, country, user agent; no IP addresses) to improve what it can answer, and deletes logs after 12 months. See gingerlive.io/privacy.

Resources

gingerlive://company: company facts (JSON)
gingerlive://guides: resource guides on livestream advertising (JSON)
https://gingerlive.io/llms.txt: the canonical llms.txt, fetched live

Prompts

plan_livestream_campaign: scope a livestream ad campaign for a brand (optional goal, budget)
get_started_as_streamer: help a streamer evaluate and join the program (optional platform)

Connect

Claude (claude.ai / Desktop): Settings → Connectors → Add custom connector → https://mcp.gingerlive.io/mcp

Claude Code:

bash

claude mcp add --transport http gingerlive https://mcp.gingerlive.io/mcp

Cursor, VS Code and other clients (mcp.json):

json

{
  "mcpServers": {
    "gingerlive": { "url": "https://mcp.gingerlive.io/mcp" }
  }
}

Run it locally over stdio (same tools, no network needed except the live llms.txt resource):

bash

git clone https://github.com/gingerlive-io/gingerlive-mcp && cd gingerlive-mcp && npm install

json

{
  "mcpServers": {
    "gingerlive": { "command": "npx", "args": ["tsx", "/path/to/gingerlive-mcp/src/stdio.ts"] }
  }
}

Or with Docker: docker build -t gingerlive-mcp . && docker run -i --rm gingerlive-mcp

Then ask things like "What livestream ad formats does GingerLive offer?", "Show me GingerLive's campaign case studies" or "How can I monetize my Kick stream?"

How it works

Tools, resources and prompts are registered once in src/server.ts and served two ways: src/index.ts (the hosted Cloudflare Worker) and src/stdio.ts (a local stdio process). The Worker is built with the Agents SDK (McpAgent) and the official MCP TypeScript SDK. Every answer comes from src/data/agent-data.json, a static snapshot generated from the same source as gingerlive.io/llms.txt, so the server only ever returns information that is already public on gingerlive.io.

Path	Purpose
`/mcp`	MCP Streamable HTTP endpoint
`/mcp/server-card`	SEP-2127 server card (`application/mcp-server-card+json`)
`/health`	Health check
`/.well-known/mcp`	SEP-1960 manifest
`/.well-known/mcp.json`	Registry server card

Run it yourself

bash

npm install
npm run stdio    # local stdio server
npm run dev      # local Worker at http://localhost:8787/mcp
npm run deploy   # to your own Cloudflare account (change the route in wrangler.jsonc first)

Usage logging needs a D1 database on your account: npx wrangler d1 create <name>, put its name and id in wrangler.jsonc, then npx wrangler d1 migrations apply <name> --remote. For local dev, apply with --local. The stdio server does not log.

Inspect it with the MCP Inspector:

bash

npx @modelcontextprotocol/inspector

About GingerLive

GingerLive is a livestream advertising platform. Its Streamsense AI places non-intrusive, unskippable ads at the right live moment, so streamers earn from their content and brands reach Gen Z at scale.

License

Install

Tools (6)

get_company_overviewget_network_statslist_ad_formatslist_case_studiesget_case_studyget_streamer_program_info

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.gingerlive.io/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.gingerlive.io/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.gingerlive/mcp (Model Context Protocol) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

Topics

get_company_overview

get_network_stats

list_ad_formats

list_case_studies

get_case_study

get_streamer_program_info

GingerLive MCP Server

What it can do

Tools

Resources

Prompts

Connect

How it works

Run it yourself

About GingerLive

License

Install

Remote endpoint

Related servers