Skip to main content
Glama
kevinnz

humanitix-mcp

by kevinnz
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

humanitix-mcp

A read-only MCP (Model Context Protocol) server for the Humanitix Public API.

This repository contains the completed Phase 1-4 implementation: a uv project, an async read-only Humanitix HTTP client, Pydantic response models, deterministic trimmed formatting helpers, and a stdio MCP server that exposes nine read-only tools. Phase 5 live smoke testing is pending a real API key.

Setup

This project uses uv and requires Python 3.11+.

uv sync --extra dev

Copy .env.example to .env and add a real API key when available:

cp .env.example .env

The server reads HUMANITIX_API_KEY and HUMANITIX_BASE_URL from the environment. HUMANITIX_BASE_URL defaults to https://api.humanitix.com.

Related MCP server: hit-mcp

Running the server

The server communicates over stdio and is the MCP transport expected by Claude Desktop and MCP Inspector:

uv run humanitix-mcp

With the MCP Inspector:

npx @modelcontextprotocol/inspector uv run humanitix-mcp

The server creates one HumanitixClient per stdio connection and closes it when the connection ends.

Project structure

  • src/humanitix_mcp/ — Python package.

    • server.py — MCP server entry point and tool handlers (Phase 4).

    • client.py — Async Humanitix API HTTP client with auth, retry, and pagination (Phase 2).

    • models.py — Pydantic response models (Phase 3).

    • formatting.py — Deterministic response trimming helpers with a raw-payload opt-in escape hatch (Phase 3).

  • tests/ — Test suite.

  • tests/fixtures/ — Redacted JSON fixtures for model and formatting tests.

Tool catalog

The server exposes nine read-only tools:

Tool

Purpose

humanitix_list_events

List events with optional future-only and since filters.

humanitix_get_event

Fetch one event by event_id.

humanitix_list_event_dates

List the dates/sessions for an event; event-date IDs are required by the order, ticket, and check-in tools.

humanitix_list_orders

List orders for a specific event date.

humanitix_get_order

Fetch one order by order_id.

humanitix_list_tickets

List tickets for a specific event date, optionally filtered by status.

humanitix_get_ticket

Fetch one ticket by ticket_id.

humanitix_get_check_in_count

Get check-in totals for an event date (BETA endpoint).

humanitix_sales_summary

Aggregate tickets for an event date into sold/cancelled counts, gross revenue (when price data is present), and capacity utilisation (when capacity is present).

All list tools support page_size (1-100) and max_items (default 500). All data-returning tools support raw=true to return the full Humanitix payload instead of the trimmed summary.

Read-only boundary

The server only implements read-only tools. No write endpoints, check-in/check-out actions, transfers, or network listeners are exposed.

Structured errors

Expected failures are returned as JSON dictionaries with success: false and a human-readable error message. This covers missing configuration, invalid arguments, authentication, authorization, not-found, validation, server, and transport failures. Error messages never include the API key or raw tracebacks.

Running tests

uv run pytest

Implementation status

  • Phase 1: Scaffold

  • Phase 2: HTTP client (client.py)

  • Phase 3: Response models and trimming (models.py, formatting.py)

  • Phase 4: MCP server and tools (server.py)

  • Phase 5: Live smoke test (requires a real HUMANITIX_API_KEY and is not part of this phase)

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • humaans-mcp

    ptorsten
    A
    license
    B
    quality
    C
    maintenance
    Read-only MCP server for the Humaans HRIS API, providing tools to query people, reporting chains, compensation, time away, and more.
    Last updated
    33
    MIT

  • Eventbrite MCP Server

    marek-knappe
    F
    license
    -
    quality
    B
    maintenance
    Full MCP server for the Eventbrite API with 73 tools to manage events, attendees, orders, tickets, venues, discounts, reports, webhooks, and more.
    Last updated

View all related MCP servers

Related MCP Connectors

  • mcp-server

    Read-only MCP server for Muovi, Argentina's trust-first local services marketplace (6 tools).

  • classquill-mcp

    Read-only MCP server for ClassQuill, a tutoring-business-management platform.

  • better-notion-mcp

    Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kevinnz/humanitix-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server