Humanitix MCP by usefulapi is an MCP server published by io.usefulapi, hosted at humanitix.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 15 tools, including humanitix_list_events, humanitix_get_event, humanitix_get_check_in_count, humanitix_list_orders, humanitix_get_order.
Read Humanitix events, orders, tickets and live check-in counts, and check tickets in or out.
4,198 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List your events, newest first, with dates, ticket types, pricing and capacity. Filter to upcoming events or events changed since a date. Paged (total/page/pageSize in the response). Humanitix: GET /v1/events.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. Defaults to 1. |
| since | string | Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z. |
| page_size | integer | Results per page, 1-100 (API default 100). |
| in_future_only | boolean | Only events whose end date is in the future. |
| override_location |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| string |
| Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
{
"name": "humanitix_list_events",
"title": "List events",
"description": "List your events, newest first, with dates, ticket types, pricing and capacity. Filter to upcoming events or events changed since a date. Paged (total/page/pageSize in the response). Humanitix: GET /v1/events.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. Defaults to 1."
},
"since": {
"type": "string",
"description": "Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (API default 100)."
},
"in_future_only": {
"type": "boolean",
"description": "Only events whose end date is in the future."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
}
}
},
"annotations": {
"title": "List events",
"readOnlyHint": true
}
}Fetch one event: name, description, URL, dates (each date's _id is the event_date_id other tools take), ticket types, packaged tickets, pricing, location, capacity and publish state. Humanitix: GET /v1/events/{eventId}.
| Parameter | Type | Description |
|---|---|---|
| event_id * | string | The event id (24-character hex id). |
| override_location | string | Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
{
"name": "humanitix_get_event",
"title": "Get one event",
"description": "Fetch one event: name, description, URL, dates (each date's _id is the event_date_id other tools take), ticket types, packaged tickets, pricing, location, capacity and publish state. Humanitix: GET /v1/events/{eventId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"event_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event id (24-character hex id)."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
}
}
},
"annotations": {
"title": "Get one event",
"readOnlyHint": true
}
}How many attendees have checked in for one date of an event, in total and per ticket type (ticket types with sales only, most check-ins first). BETA endpoint. Humanitix: GET /v1/events/{eventId}/check-in-count.
| Parameter | Type | Description |
|---|---|---|
| event_id * | string | The event id (24-character hex id). |
| event_date_id * | string | The event date id (24-character hex id). |
{
"name": "humanitix_get_check_in_count",
"title": "Get check-in count",
"description": "How many attendees have checked in for one date of an event, in total and per ticket type (ticket types with sales only, most check-ins first). BETA endpoint. Humanitix: GET /v1/events/{eventId}/check-in-count.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"event_date_id"
],
"properties": {
"event_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event id (24-character hex id)."
},
"event_date_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event date id (24-character hex id)."
}
}
},
"annotations": {
"title": "Get check-in count",
"readOnlyHint": true
}
}List the orders for an event (optionally one date of it): buyer name/email, financial status, totals, discounts, payment type and sales channel. Paged. Humanitix: GET /v1/events/{eventId}/orders.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. Defaults to 1. |
| since | string | Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z. |
| event_id * | string | The event id (24-character hex id). |
| page_size | integer | Results per page, 1-100 (API default 100). |
| event_date_id | string | The event date id (24-character hex id). |
| override_location | string | Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
{
"name": "humanitix_list_orders",
"title": "List an event's orders",
"description": "List the orders for an event (optionally one date of it): buyer name/email, financial status, totals, discounts, payment type and sales channel. Paged. Humanitix: GET /v1/events/{eventId}/orders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. Defaults to 1."
},
"since": {
"type": "string",
"description": "Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z."
},
"event_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event id (24-character hex id)."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (API default 100)."
},
"event_date_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event date id (24-character hex id)."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
}
}
},
"annotations": {
"title": "List an event's orders",
"readOnlyHint": true
}
}Fetch one order of an event, with its totals breakdown, answers to checkout questions and buyer details. Humanitix: GET /v1/events/{eventId}/orders/{orderId}.
| Parameter | Type | Description |
|---|---|---|
| event_id * | string | The event id (24-character hex id). |
| order_id * | string | The order id (24-character hex id). |
| override_location | string | Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
{
"name": "humanitix_get_order",
"title": "Get one order",
"description": "Fetch one order of an event, with its totals breakdown, answers to checkout questions and buyer details. Humanitix: GET /v1/events/{eventId}/orders/{orderId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"order_id"
],
"properties": {
"event_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event id (24-character hex id)."
},
"order_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The order id (24-character hex id)."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
}
}
},
"annotations": {
"title": "Get one order",
"readOnlyHint": true
}
}List the tickets (attendees) for an event, optionally one date of it and complete or cancelled only: attendee name, ticket type, price, check-in state and seating. Paged. Humanitix: GET /v1/events/{eventId}/tickets.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. Defaults to 1. |
| since | string | Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z. |
| status | string | Only tickets with this status. |
| event_id * | string | The event id (24-character hex id). |
| page_size | integer | Results per page, 1-100 (API default 100). |
| event_date_id | string | The event date id (24-character hex id). |
| override_location | string | Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
{
"name": "humanitix_list_tickets",
"title": "List an event's tickets",
"description": "List the tickets (attendees) for an event, optionally one date of it and complete or cancelled only: attendee name, ticket type, price, check-in state and seating. Paged. Humanitix: GET /v1/events/{eventId}/tickets.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. Defaults to 1."
},
"since": {
"type": "string",
"description": "Only results created/updated since this ISO 8601 date-time, e.g. 2026-01-01T00:00:00.000Z."
},
"status": {
"enum": [
"complete",
"cancelled"
],
"type": "string",
"description": "Only tickets with this status."
},
"event_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event id (24-character hex id)."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (API default 100)."
},
"event_date_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event date id (24-character hex id)."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
}
}
},
"annotations": {
"title": "List an event's tickets",
"readOnlyHint": true
}
}Fetch one ticket of an event, including its check-in history and any swap history. Humanitix: GET /v1/events/{eventId}/tickets/{ticketId}.
| Parameter | Type | Description |
|---|---|---|
| event_id * | string | The event id (24-character hex id). |
| ticket_id * | string | The ticket id (24-character hex id). |
| override_location | string | Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
{
"name": "humanitix_get_ticket",
"title": "Get one ticket",
"description": "Fetch one ticket of an event, including its check-in history and any swap history. Humanitix: GET /v1/events/{eventId}/tickets/{ticketId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"ticket_id"
],
"properties": {
"event_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event id (24-character hex id)."
},
"ticket_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The ticket id (24-character hex id)."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
}
}
},
"annotations": {
"title": "Get one ticket",
"readOnlyHint": true
}
}List the tags you use to group events (events carry them in tagIds). Paged. Humanitix: GET /v1/tags.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. Defaults to 1. |
| page_size | integer | Results per page, 1-100 (API default 100). |
{
"name": "humanitix_list_tags",
"title": "List tags",
"description": "List the tags you use to group events (events carry them in tagIds). Paged. Humanitix: GET /v1/tags.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. Defaults to 1."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (API default 100)."
}
}
},
"annotations": {
"title": "List tags",
"readOnlyHint": true
}
}Fetch one tag by id. Humanitix: GET /v1/tags/{tagId}.
| Parameter | Type | Description |
|---|---|---|
| tag_id * | string | The tag id (24-character hex id). |
{
"name": "humanitix_get_tag",
"title": "Get one tag",
"description": "Fetch one tag by id. Humanitix: GET /v1/tags/{tagId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tag_id"
],
"properties": {
"tag_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The tag id (24-character hex id)."
}
}
},
"annotations": {
"title": "Get one tag",
"readOnlyHint": true
}
}List public events from across the whole Humanitix platform, filterable by type, category and subcategory. Requires a special permission Humanitix activates on your account (403 otherwise). Paged. Humanitix: GET /v1/global/events.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. Defaults to 1. |
| type | string | Event type, e.g. concertOrPerformance. |
| category | string | Event category, e.g. music. |
| page_size | integer | Results per page, 1-100 (API default 100). |
| subcategory | string | Subcategory within the category (e.g. jazz for music). Requires category. |
| override_location | string | Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
| with_artists_only | boolean | Only events that list artists. |
{
"name": "humanitix_list_global_events",
"title": "List platform-wide events",
"description": "List public events from across the whole Humanitix platform, filterable by type, category and subcategory. Requires a special permission Humanitix activates on your account (403 otherwise). Paged. Humanitix: GET /v1/global/events.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. Defaults to 1."
},
"type": {
"enum": [
"appearanceOrSigning",
"attraction",
"campTripOrRetreat",
"classTrainingOrWorkshop",
"concertOrPerformance",
"conference",
"convention",
"dinnerOrGala",
"festivalOrFair",
"gameOrCompetition",
"meetingOrNetworkingEvent",
"partyOrSocialGathering",
"raceOrEnduranceEvent",
"rally",
"screening",
"seminarOrTalk",
"tour",
"tournament",
"tradeShowConsumerShowOrExpo",
"other"
],
"type": "string",
"description": "Event type, e.g. concertOrPerformance."
},
"category": {
"enum": [
"autoBoatAndAir",
"businessAndProfessional",
"charityAndCauses",
"communityAndCulture",
"familyAndEducation",
"fashionAndBeauty",
"filmMediaAndEntertainment",
"foodAndDrink",
"governmentAndPolitics",
"healthAndWellness",
"hobbiesAndSpecialInterest",
"homeAndLifestyle",
"music",
"performingAndVisualArts",
"religionAndSpirituality",
"schoolActivities",
"scienceAndTechnology",
"seasonalAndHoliday",
"sportsAndFitness",
"travelAndOutdoor",
"other"
],
"type": "string",
"description": "Event category, e.g. music."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (API default 100)."
},
"subcategory": {
"type": "string",
"description": "Subcategory within the category (e.g. jazz for music). Requires category."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
},
"with_artists_only": {
"type": "boolean",
"description": "Only events that list artists."
}
}
},
"annotations": {
"title": "List platform-wide events",
"readOnlyHint": true
}
}List individual event dates from across the platform — one row per date — with the public on-sale status of every ticket type. Requires a special permission Humanitix activates on your account (403 otherwise). Paged. Humanitix: GET /v1/global/event-dates.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. Defaults to 1. |
| type | string | Event type, e.g. concertOrPerformance. |
| category | string | Event category, e.g. music. |
| page_size | integer | Results per page, 1-100 (API default 100). |
| subcategory | string | Subcategory within the category (e.g. jazz for music). Requires category. |
| override_location | string | Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
| with_artists_only | boolean | Only events that list artists. |
{
"name": "humanitix_list_global_event_dates",
"title": "List platform-wide event dates",
"description": "List individual event dates from across the platform — one row per date — with the public on-sale status of every ticket type. Requires a special permission Humanitix activates on your account (403 otherwise). Paged. Humanitix: GET /v1/global/event-dates.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. Defaults to 1."
},
"type": {
"enum": [
"appearanceOrSigning",
"attraction",
"campTripOrRetreat",
"classTrainingOrWorkshop",
"concertOrPerformance",
"conference",
"convention",
"dinnerOrGala",
"festivalOrFair",
"gameOrCompetition",
"meetingOrNetworkingEvent",
"partyOrSocialGathering",
"raceOrEnduranceEvent",
"rally",
"screening",
"seminarOrTalk",
"tour",
"tournament",
"tradeShowConsumerShowOrExpo",
"other"
],
"type": "string",
"description": "Event type, e.g. concertOrPerformance."
},
"category": {
"enum": [
"autoBoatAndAir",
"businessAndProfessional",
"charityAndCauses",
"communityAndCulture",
"familyAndEducation",
"fashionAndBeauty",
"filmMediaAndEntertainment",
"foodAndDrink",
"governmentAndPolitics",
"healthAndWellness",
"hobbiesAndSpecialInterest",
"homeAndLifestyle",
"music",
"performingAndVisualArts",
"religionAndSpirituality",
"schoolActivities",
"scienceAndTechnology",
"seasonalAndHoliday",
"sportsAndFitness",
"travelAndOutdoor",
"other"
],
"type": "string",
"description": "Event category, e.g. music."
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (API default 100)."
},
"subcategory": {
"type": "string",
"description": "Subcategory within the category (e.g. jazz for music). Requires category."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
},
"with_artists_only": {
"type": "boolean",
"description": "Only events that list artists."
}
}
},
"annotations": {
"title": "List platform-wide event dates",
"readOnlyHint": true
}
}Mark a ticket as checked in at the door. Returns any scanning messages configured for that ticket. Undo with humanitix_check_out_ticket. Humanitix: POST /v1/events/{eventId}/tickets/{ticketId}/check-in.
| Parameter | Type | Description |
|---|---|---|
| event_id * | string | The event id (24-character hex id). |
| ticket_id * | string | The ticket id (24-character hex id). |
| override_location | string | Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
{
"name": "humanitix_check_in_ticket",
"title": "Check in a ticket",
"description": "Mark a ticket as checked in at the door. Returns any scanning messages configured for that ticket. Undo with humanitix_check_out_ticket. Humanitix: POST /v1/events/{eventId}/tickets/{ticketId}/check-in.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"ticket_id"
],
"properties": {
"event_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event id (24-character hex id)."
},
"ticket_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The ticket id (24-character hex id)."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
}
}
},
"annotations": {
"title": "Check in a ticket",
"destructiveHint": true
}
}Mark a checked-in ticket as checked out (e.g. to undo a mistaken check-in or track re-entry). Humanitix: POST /v1/events/{eventId}/tickets/{ticketId}/check-out.
| Parameter | Type | Description |
|---|---|---|
| event_id * | string | The event id (24-character hex id). |
| ticket_id * | string | The ticket id (24-character hex id). |
| override_location | string | Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
{
"name": "humanitix_check_out_ticket",
"title": "Check out a ticket",
"description": "Mark a checked-in ticket as checked out (e.g. to undo a mistaken check-in or track re-entry). Humanitix: POST /v1/events/{eventId}/tickets/{ticketId}/check-out.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"ticket_id"
],
"properties": {
"event_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event id (24-character hex id)."
},
"ticket_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The ticket id (24-character hex id)."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
}
}
},
"annotations": {
"title": "Check out a ticket",
"destructiveHint": true
}
}Create a base event (name, description, timezone, one or more date ranges, location, keywords, classification). Ticket types are then set up in the Humanitix console. Requires a special permission Humanitix activates on your account (403 otherwise). Humanitix: POST /v1/events.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Event name. |
| dates * | array | One or more date ranges (1-700). |
| keywords | array | Up to 10 unique search keywords, each 1-25 characters. |
| timezone * | string | IANA timezone, e.g. Australia/Sydney or Pacific/Auckland. |
| description | string | Event description. |
| classification | object | How the event is classified. subcategory must belong to category. |
| event_location | any | Where the event happens: online, address (geocoded), custom (free text) or toBeAnnounced. |
| override_location | string | Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
{
"name": "humanitix_create_event",
"title": "Create an event",
"description": "Create a base event (name, description, timezone, one or more date ranges, location, keywords, classification). Ticket types are then set up in the Humanitix console. Requires a special permission Humanitix activates on your account (403 otherwise). Humanitix: POST /v1/events.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"timezone",
"dates"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Event name."
},
"dates": {
"type": "array",
"items": {
"type": "object",
"required": [
"startDate",
"endDate"
],
"properties": {
"endDate": {
"type": "string",
"minLength": 1,
"description": "End as an ISO 8601 date-time, e.g. 2026-11-01T09:00:00.000Z."
},
"startDate": {
"type": "string",
"minLength": 1,
"description": "Start as an ISO 8601 date-time, e.g. 2026-11-01T09:00:00.000Z."
}
}
},
"maxItems": 700,
"minItems": 1,
"description": "One or more date ranges (1-700)."
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 25,
"minLength": 1
},
"maxItems": 10,
"description": "Up to 10 unique search keywords, each 1-25 characters."
},
"timezone": {
"type": "string",
"minLength": 1,
"description": "IANA timezone, e.g. Australia/Sydney or Pacific/Auckland."
},
"description": {
"type": "string",
"description": "Event description."
},
"classification": {
"type": "object",
"properties": {
"type": {
"enum": [
"appearanceOrSigning",
"attraction",
"campTripOrRetreat",
"classTrainingOrWorkshop",
"concertOrPerformance",
"conference",
"convention",
"dinnerOrGala",
"festivalOrFair",
"gameOrCompetition",
"meetingOrNetworkingEvent",
"partyOrSocialGathering",
"raceOrEnduranceEvent",
"rally",
"screening",
"seminarOrTalk",
"tour",
"tournament",
"tradeShowConsumerShowOrExpo",
"other"
],
"type": "string",
"description": "Event type, e.g. concertOrPerformance."
},
"category": {
"enum": [
"autoBoatAndAir",
"businessAndProfessional",
"charityAndCauses",
"communityAndCulture",
"familyAndEducation",
"fashionAndBeauty",
"filmMediaAndEntertainment",
"foodAndDrink",
"governmentAndPolitics",
"healthAndWellness",
"hobbiesAndSpecialInterest",
"homeAndLifestyle",
"music",
"performingAndVisualArts",
"religionAndSpirituality",
"schoolActivities",
"scienceAndTechnology",
"seasonalAndHoliday",
"sportsAndFitness",
"travelAndOutdoor",
"other"
],
"type": "string",
"description": "Event category, e.g. music."
},
"subcategory": {
"type": "string",
"description": "Subcategory within the category (e.g. jazz for music). Requires category."
}
},
"description": "How the event is classified. subcategory must belong to category."
},
"event_location": {
"oneOf": [
{
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"const": "online"
},
"onlineUrl": {
"type": "string",
"description": "Link attendees join at."
},
"instructions": {
"type": "string",
"description": "Joining instructions."
}
}
},
{
"type": "object",
"required": [
"type",
"address",
"venueName",
"latLng"
],
"properties": {
"type": {
"type": "string",
"const": "address"
},
"latLng": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 2,
"minItems": 2,
"description": "[latitude, longitude]."
},
"address": {
"type": "string",
"description": "Full street address."
},
"placeId": {
"type": "string",
"description": "Google Places place_id."
},
"venueName": {
"type": "string",
"description": "Venue name (may be empty)."
}
}
},
{
"type": "object",
"required": [
"type",
"address",
"venueName"
],
"properties": {
"type": {
"type": "string",
"const": "custom"
},
"address": {
"type": "string",
"minLength": 1,
"description": "Free-text address."
},
"venueName": {
"type": "string",
"minLength": 1,
"description": "Venue name."
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"const": "toBeAnnounced"
}
}
}
],
"description": "Where the event happens: online, address (geocoded), custom (free text) or toBeAnnounced."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
}
}
},
"annotations": {
"title": "Create an event",
"destructiveHint": true
}
}Update an event's name, description, timezone, location, keywords or classification, and add or reschedule dates (date operations CREATE and UPDATE; deleting dates is not exposed). Only fields you pass are sent. Requires a special permission Humanitix activates on your account (403 otherwise). Humanitix: PATCH /v1/events/{eventId}.
| Parameter | Type | Description |
|---|---|---|
| name | string | New event name. |
| dates | array | Date operations: CREATE a new date range, or UPDATE an existing one by its _id. |
| event_id * | string | The event id (24-character hex id). |
| keywords | array | Up to 10 unique search keywords, each 1-25 characters. |
| timezone | string | New IANA timezone. |
| description | string | New description. |
| classification | object | How the event is classified. subcategory must belong to category. |
| event_location | any | Where the event happens: online, address (geocoded), custom (free text) or toBeAnnounced. |
| override_location | string | Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region. |
{
"name": "humanitix_update_event",
"title": "Update an event",
"description": "Update an event's name, description, timezone, location, keywords or classification, and add or reschedule dates (date operations CREATE and UPDATE; deleting dates is not exposed). Only fields you pass are sent. Requires a special permission Humanitix activates on your account (403 otherwise). Humanitix: PATCH /v1/events/{eventId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "New event name."
},
"dates": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"operation",
"startDate",
"endDate"
],
"properties": {
"endDate": {
"type": "string",
"minLength": 1,
"description": "End as an ISO 8601 date-time, e.g. 2026-11-01T09:00:00.000Z."
},
"operation": {
"type": "string",
"const": "CREATE"
},
"startDate": {
"type": "string",
"minLength": 1,
"description": "Start as an ISO 8601 date-time, e.g. 2026-11-01T09:00:00.000Z."
}
}
},
{
"type": "object",
"required": [
"operation",
"_id",
"startDate",
"endDate"
],
"properties": {
"_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The date range id (the _id inside the event's dates) (24-character hex id)."
},
"endDate": {
"type": "string",
"minLength": 1,
"description": "New end as an ISO 8601 date-time, e.g. 2026-11-01T09:00:00.000Z."
},
"operation": {
"type": "string",
"const": "UPDATE"
},
"startDate": {
"type": "string",
"minLength": 1,
"description": "New start as an ISO 8601 date-time, e.g. 2026-11-01T09:00:00.000Z."
}
}
}
]
},
"maxItems": 700,
"minItems": 1,
"description": "Date operations: CREATE a new date range, or UPDATE an existing one by its _id."
},
"event_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The event id (24-character hex id)."
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 25,
"minLength": 1
},
"maxItems": 10,
"description": "Up to 10 unique search keywords, each 1-25 characters."
},
"timezone": {
"type": "string",
"minLength": 1,
"description": "New IANA timezone."
},
"description": {
"type": "string",
"description": "New description."
},
"classification": {
"type": "object",
"properties": {
"type": {
"enum": [
"appearanceOrSigning",
"attraction",
"campTripOrRetreat",
"classTrainingOrWorkshop",
"concertOrPerformance",
"conference",
"convention",
"dinnerOrGala",
"festivalOrFair",
"gameOrCompetition",
"meetingOrNetworkingEvent",
"partyOrSocialGathering",
"raceOrEnduranceEvent",
"rally",
"screening",
"seminarOrTalk",
"tour",
"tournament",
"tradeShowConsumerShowOrExpo",
"other"
],
"type": "string",
"description": "Event type, e.g. concertOrPerformance."
},
"category": {
"enum": [
"autoBoatAndAir",
"businessAndProfessional",
"charityAndCauses",
"communityAndCulture",
"familyAndEducation",
"fashionAndBeauty",
"filmMediaAndEntertainment",
"foodAndDrink",
"governmentAndPolitics",
"healthAndWellness",
"hobbiesAndSpecialInterest",
"homeAndLifestyle",
"music",
"performingAndVisualArts",
"religionAndSpirituality",
"schoolActivities",
"scienceAndTechnology",
"seasonalAndHoliday",
"sportsAndFitness",
"travelAndOutdoor",
"other"
],
"type": "string",
"description": "Event category, e.g. music."
},
"subcategory": {
"type": "string",
"description": "Subcategory within the category (e.g. jazz for music). Requires category."
}
},
"description": "How the event is classified. subcategory must belong to category."
},
"event_location": {
"oneOf": [
{
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"const": "online"
},
"onlineUrl": {
"type": "string",
"description": "Link attendees join at."
},
"instructions": {
"type": "string",
"description": "Joining instructions."
}
}
},
{
"type": "object",
"required": [
"type",
"address",
"venueName",
"latLng"
],
"properties": {
"type": {
"type": "string",
"const": "address"
},
"latLng": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 2,
"minItems": 2,
"description": "[latitude, longitude]."
},
"address": {
"type": "string",
"description": "Full street address."
},
"placeId": {
"type": "string",
"description": "Google Places place_id."
},
"venueName": {
"type": "string",
"description": "Venue name (may be empty)."
}
}
},
{
"type": "object",
"required": [
"type",
"address",
"venueName"
],
"properties": {
"type": {
"type": "string",
"const": "custom"
},
"address": {
"type": "string",
"minLength": 1,
"description": "Free-text address."
},
"venueName": {
"type": "string",
"minLength": 1,
"description": "Venue name."
}
}
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"const": "toBeAnnounced"
}
}
}
],
"description": "Where the event happens: online, address (geocoded), custom (free text) or toBeAnnounced."
},
"override_location": {
"enum": [
"AU",
"NZ",
"US",
"FJ",
"CA",
"GB",
"SG",
"DE",
"MY",
"MX"
],
"type": "string",
"description": "Query a region other than your account's own (ISO 3166-1 alpha-2). Humanitix stores data per region."
}
}
},
"annotations": {
"title": "Update an event",
"destructiveHint": true
}
}Tools for Humanitix, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many tickets have we sold for my next event?"; "How many attendees have already checked in at tonight's event?"; "Show me the orders for my workshop with buyer names and emails.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Humanitix data. Free plan: 50 tool calls per month. Run humanitix_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run humanitix_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run humanitix_upgrade without a plan: it returns both plans, each with a payment link for the user to open. humanitix_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.