@ticketlink/mcp-server

Model Context Protocol (MCP) server for TicketLink - Search Korean concerts, musicals, sports events and get ticket open information.

⚡ Quick Start (3 Steps)

1. Open Cursor MCP config

• Mac/Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json

2. Add this config

{
  "mcpServers": {
    "ticketlink": {
      "command": "npx",
      "args": ["-y", "@ticketlink/mcp-server"]
    }
  }
}

3. Restart Cursor

Try it: Ask Cursor AI in Korean:

판매중인 뮤지컬 찾아줘
god 콘서트 언제야?

That's it! 🎉

Features

• 🎭 Search Events: Search for concerts, musicals, sports events, and more
• 🎫 Ticket Information: Get detailed ticket info including prices, venues, and dates
• 📅 Ticket Open Banners: View upcoming ticket sales and open dates
• 🔍 Advanced Filtering: Filter by sale status (on sale, sold out, upcoming)

Installation

For Cursor Users (Recommended)

No installation required! Use npx to run the server directly.

Add this to your Cursor MCP settings (~/.cursor/mcp.json or Cursor Settings):

{
  "mcpServers": {
    "ticketlink": {
      "command": "npx",
      "args": ["-y", "@ticketlink/mcp-server"],
      "env": {
        "TL_ORIGIN": "https://mapi.ticketlink.co.kr"
      }
    }
  }
}

Alternative: Global Installation

npm install -g @ticketlink/mcp-server

Then configure:

{
  "mcpServers": {
    "ticketlink": {
      "command": "ticketlink-mcp",
      "env": {
        "TL_ORIGIN": "https://mapi.ticketlink.co.kr"
      }
    }
  }
}

Configuration

Cursor Settings Location

• macOS: ~/Library/Application Support/Cursor/User/settings.json or ~/.cursor/mcp.json
• Linux: ~/.config/Cursor/User/settings.json or ~/.cursor/mcp.json
• Windows: %APPDATA%\Cursor\User\settings.json or %USERPROFILE%\.cursor\mcp.json

Environment Variables

| Variable | Description | Default | | ----------- | --------------------- | ------------------------------- | | TL_ORIGIN | TicketLink API origin | https://mapi.ticketlink.co.kr |

Available Tools

1. search_products

Search for events and performances on TicketLink.

Parameters:

• query (string, required): Search keyword (e.g., "뮤지컬", "BTS", "스포츠")
• searchConditionType (enum, default: "GENERAL"):
  • GENERAL: All results
  • FOR_SALE: Only items currently on sale
• limit (number, default: 10, max: 50): Maximum number of results

Example usage in Cursor:

Find musicals currently on sale
Search for god concerts
Show me sports events

2. list_ticket_open_banners

Get ticket open banner information for upcoming events.

Parameters:

• codeName (string, default: "WEB_TICKET_OPEN"): Banner code
• page (number, default: 1): Page number
• size (number, default: 20, max: 100): Results per page

Example usage in Cursor:

Show me upcoming ticket openings
What tickets are opening soon?

Usage Examples

Once configured in Cursor, simply ask in natural language:

판매중인 뮤지컬 찾아줘
Find god concerts
What sports events are available?
가장 가까운 날짜에 오픈하는 티켓 알려줘

Or call tools directly:

@ticketlink search_products query="뮤지컬" searchConditionType="FOR_SALE" limit=10
@ticketlink list_ticket_open_banners page=1 size=20

API Endpoints

This MCP server uses the following TicketLink APIs:

1. Search API: https://ticketlink.co.kr/search/getSearchList

   • Used by search_products tool
   • Returns event information, prices, venues, dates

2. Banner API: https://mapi.ticketlink.co.kr/mapi/web/main/home

   • Used by list_ticket_open_banners tool
   • Returns upcoming ticket open information

Development

See the main repository for development instructions.

License

ISC

Support

• Issues: GitHub Issues
• Repository: GitHub

Related

• Main repository: @ticketlink-mcp
• Shared schemas: @ticketlink-mcp/shared