Skip to main content

​
What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external tools. The ticketnation-mcp server exposes the Ticketnation Open API as tools that AI agents can call directly.
Available on npm: ticketnation-mcp
This means you can say things like:
  • “Create a concert event at MOA Arena with VIP tickets at ₱3,500”
  • “Add DJ Shadow as a performer and build a schedule”
  • “How many tickets have been sold for my latest event?”
  • “Set up a webhook for order notifications”

​
Installation

Add to your claude_desktop_config.json:
{
  "mcpServers": {
    "ticketnation": {
      "command": "npx",
      "args": ["-y", "ticketnation-mcp"],
      "env": {
        "TICKETNATION_API_KEY": "tn_live_your_key_here"
      }
    }
  }
}
Restart Claude Desktop after saving.
Never hardcode your API key in shared config files. Use environment variable references where supported, or keep the config file in .gitignore.

​
Environment Variables

VariableRequiredDescription
TICKETNATION_API_KEYYesYour API key from Organizer Dashboard > Settings > API Keys
TICKETNATION_BASE_URLNoOverride API URL (default: https://api.ticketnation.ph). Use http://localhost:4000 for local development.

​
Available Tools

ToolDescription
create_eventCreate a new event in DRAFT status
create_and_publish_eventCreate and publish in one step (includes inline tickets)
list_eventsList events with status/search filters
get_eventGet event details by ID or slug
publish_eventPublish a DRAFT event to the marketplace
unpublish_eventRevert a published event to DRAFT
ToolDescription
create_ticketAdd a ticket type with pricing and quantity
list_ticketsList all ticket types for an event
mark_ticket_sold_outSet remaining quantity to 0
ToolDescription
add_performerAdd an artist, DJ, speaker, or host
list_performersList the event lineup
ToolDescription
add_schedule_itemAdd a timetable entry (optionally linked to a performer)
list_scheduleList all schedule items
ToolDescription
add_brandAdd a sponsor or partner brand
list_brandsList brand partners
ToolDescription
list_ordersList orders for an event (read-only)
ToolDescription
search_venuesSearch public venues by name
ToolDescription
create_webhookCreate a webhook endpoint
list_webhooksList all webhooks
ToolDescription
get_account_infoVerify connection and see scopes

​
Example Conversations

​
Create a full event

You: Create a music festival called “Manila Beats 2026” at Mall of Asia Arena on October 15, 2026 from 6pm to 11pm. Add GA tickets at ₱1,500 and VIP at ₱5,000 with 500 and 100 capacity. Use this image: https://example.com/manila-beats.jpg
The AI agent will:
  1. Call search_venues to find “Mall of Asia Arena”
  2. Call create_and_publish_event with the venue ID, image, and inline tickets
  3. Return the event URL on ticketnation.ph

​
Add performers and schedule

You: Add SB19 as the headliner and DJ Nix as the opening act. Build a schedule: doors at 6pm, DJ Nix from 7pm-8:30pm, SB19 from 9pm-11pm.
The AI agent will:
  1. Call add_performer twice
  2. Call add_schedule_item three times, linking performers to their time slots

​
Check sales

You: How are ticket sales going for Manila Beats 2026?
The AI agent will:
  1. Call list_events with search “Manila Beats”
  2. Call list_tickets to see remaining inventory
  3. Call list_orders to see completed purchases

​
Pricing Note

Prices are in whole pesos (not centavos). When the AI creates a ticket with price: 1500, that means ₱1,500.00. The formatPeso() utility is used internally by the MCP server to display prices in tool responses.

​
Scopes Required

The MCP server uses whatever scopes your API key has. For full functionality, enable all scopes:
ScopeTools that need it
events:readlist_events, get_event, search_venues, list_performers, list_schedule, list_brands
events:writecreate_event, create_and_publish_event, publish_event, unpublish_event, add_performer, add_schedule_item, add_brand
tickets:readlist_tickets
tickets:writecreate_ticket, mark_ticket_sold_out
orders:readlist_orders
webhooks:managecreate_webhook, list_webhooks

​
SDK vs MCP — When to Use What

Use the SDK

When you’re writing application code that programmatically creates events — e.g., a platform integration, a cron job, or a backend service.

Use the MCP

When you want AI agents to manage events conversationally — e.g., from Claude Desktop, Cursor, or a custom AI workflow.
The MCP server uses the SDK internally, so they have the same capabilities and connect to the same API.