Skip to main content
Glama

Humanitix API and MCP server for ChatGPT and Claude

Humanitix has a public API for event and ticket reads and check-in, but no official MCP server or refund, complimentary-ticket, discount-code or email endpoints according to the live Cotlet.dev page (checked 31 October 2026). Cotlet.dev connects ChatGPT, Claude and other AI agents to your own Humanitix host account through a hosted MCP server with 12 workflow tools. Six write tools ask for approval by default; duplicating an event creates an unpublished draft without approval.

What you can ask

List my Humanitix events with their dates and tickets sold.

Find an order by buyer email within the selected event.

Read the tickets in an order before preparing a refund for my approval.

Prepare complimentary tickets for my guest list and ask before issuing them.

Create a member discount code after I approve it.

Draft a buyer reminder email and ask before sending it.

Related MCP server: SecureMCP Agent Hub

Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.

ChatGPT

Settings > Apps & Connectors > Create. Use https://cotlet.dev/mcp/v1/connect with OAuth.

Claude

Settings > Connectors > Add custom connector. Use https://cotlet.dev/mcp/v1/connect.

Claude Code

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

Cursor

Copy .cursor/mcp.json from this repo into your project:

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its Humanitix tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

Clone this repository and run python3 humanitix_agent.py serve with COTLET_API_KEY set.

Or with Docker:

docker build -t humanitix-mcp .
docker run -i --rm -e COTLET_API_KEY humanitix-mcp

The local server exposes seven browser helper tools, distinct from the 12 hosted workflow tools described on the live page.

Local tools: humanitix_guide, humanitix_status, humanitix_open, humanitix_read, humanitix_click, humanitix_type, humanitix_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

Command line

Python 3.10+, nothing else to install. Run from this repo:

export COTLET_API_KEY="your-key"
python3 humanitix_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 humanitix_agent.py status    # is Humanitix ready in your Cotlet.dev account
python3 humanitix_agent.py guide     # Humanitix screens and sign-in link
python3 humanitix_agent.py read      # open Humanitix, read the page, close the browser
python3 humanitix_agent.py tools     # list Cotlet.dev tools
python3 humanitix_agent.py serve     # start the stdio MCP server (same as no argument)

Questions from Humanitix users

Does Humanitix have an official API or MCP server?

The live Cotlet.dev page, checked 31 October 2026, describes a public API for reads and check-in, but no official MCP server or endpoints for refunds, complimentary tickets, discount codes or email campaigns. A community MCP server wraps the public API.

Which account do I need?

Use your own Humanitix host account with access to the events, orders and email campaigns you want to manage. Sign in through its Cotlet Cloud Browser and enable Humanitix for agents.

Which actions ask for approval?

Refunds, resending confirmations, manual orders, discount codes, email campaigns and stopping sales ask for approval by default. Reads and duplicating an event into an unpublished draft run directly. Approval settings can be changed per tool.

Can an agent publish or delete events?

No. The duplicate_event workflow creates an unpublished draft. You publish the draft yourself in Humanitix; no tool deletes events, orders or guests.

Is this an official Humanitix integration?

No. Cotlet.dev is independent and is not affiliated with Humanitix.

Live integration

Humanitix tools and connection guide


More: https://cotlet.dev/integrations/humanitix-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=humanitix

Start free: https://cotlet.dev/signup?app=humanitix&utm_source=github&utm_medium=readme&utm_campaign=humanitix

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to securely call enterprise MCP tools with tenant-scoped RBAC, human approvals, audit logging, and multi-tool workflows across customer, order, document, and ticket data.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients such as Claude and ChatGPT to read events, performances, seating, packages, visits, transactions, and organisation context from a ticketing channel, and, when writes are enabled, create and release reservations.
      10
      MIT