Swapcard MCP Server
Swapcard MCP Server
一个 Model Context Protocol (MCP) 服务器,覆盖完整的 Swapcard API 接口 — Content、Leads、Analytics 导出和 Webhooks。
工具
类别 | 工具 | 描述 |
活动 |
| 按 ID 获取单个活动 |
| 按 ID 批量获取多个活动 | |
人员 |
| 使用筛选条件列出/搜索参会者 |
| 批量创建/更新人员(群组、条形码、演讲者角色、参展商成员资格) | |
| 从活动中删除人员 | |
议程 |
| 使用格式/演讲者/活动筛选条件列出/搜索议程 |
| 批量创建/更新议程 | |
| 删除议程 | |
参展商 |
| 列出/搜索参展商 |
| 批量创建/更新参展商 | |
| 更新单个参展商 | |
| 删除参展商 | |
文档 |
| 列出活动文档 |
| 将文档附加到活动 | |
| 更新文档 | |
| 删除文档 | |
| 创建社区级文档(v2) | |
| 更新社区级文档(v2) | |
自定义字段 |
| 按目标获取字段定义 |
| 获取 Select/MultiSelect 选项值 | |
| 创建自定义字段定义 | |
| 更新自定义字段定义 | |
| 删除自定义字段定义 | |
约见 |
| 使用状态/日期筛选条件列出约见 |
Webhooks |
| 列出 Webhook 订阅 |
| 注册新的 Webhook | |
| 更新 Webhook | |
| 删除 Webhook | |
线索 |
| Leads API 令牌可访问的参展商 |
| 获取参展商的已扫描线索 | |
| 扫描参会者徽章,可附带评分和备注 | |
分析 |
| 导出原始分析记录(REST,约 10 分钟延迟) |
Related MCP server: Microsoft Events MCP Server
设置
1. 获取 API 令牌
令牌 | 创建位置 |
| |
| Event Studio → Integrations → API Keys |
| 与 Content 令牌相同(未设置时默认使用它) |
2. 构建
npm install
npm run build3. 添加到 Claude Desktop
在 ~/Library/Application Support/Claude/claude_desktop_config.json 中:
{
"mcpServers": {
"swapcard": {
"command": "node",
"args": ["/Users/klajdishira/Documents/Swapcard-MCP/dist/index.js"],
"env": {
"SWAPCARD_CONTENT_TOKEN": "your-content-api-token",
"SWAPCARD_LEADS_TOKEN": "your-leads-api-token",
"SWAPCARD_ANALYTICS_TOKEN": "your-analytics-token"
}
}
}
}4. 添加到 Claude Code (CLI)
在项目的 .claude/settings.json 或 ~/.claude/settings.json 中:
{
"mcpServers": {
"swapcard": {
"command": "node",
"args": ["/Users/klajdishira/Documents/Swapcard-MCP/dist/index.js"],
"env": {
"SWAPCARD_CONTENT_TOKEN": "your-content-api-token",
"SWAPCARD_LEADS_TOKEN": "your-leads-api-token"
}
}
}
}速率限制(Content API)
60,000 点/分钟
标头:
X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset变更操作 = 1,000 点;对象 = 2 点;标量 = 1 点;1.5× 深度乘数
分析延迟
Analytics Export REST API:约 10 分钟
Analytics GraphQL API:约 15 分钟
Available Tools
32 toolsswapcard_create_custom_fieldC
Create a new custom field definition on an event.
Inputs: name (required), type (required), target (required), eventId (required), +3 more.
swapcard_create_documentC
Create a community-level document (v2), optionally scoped to an event.
Inputs: url (required), name (required), communityId (required), eventId, +2 more.
swapcard_create_event_documentC
Attach a new document (URL-based) to an event.
Inputs: url (required), name (required), eventId (required), description.
swapcard_create_webhookC
Register a new webhook subscription for an event.
Inputs: hooks (required), secret (required), eventId (required), endpoint (required).
swapcard_delete_custom_fieldsB
Delete custom field definitions from an event.
Inputs: eventId (required), fieldDefinitionIds (required).
swapcard_delete_event_documentsB
Delete one or more event documents by their IDs.
Inputs: eventId (required), documentIds (required).
swapcard_delete_event_peopleB
Permanently delete people from an event by their Swapcard person IDs.
Inputs: eventId (required), eventPeopleIds (required).
swapcard_delete_exhibitorsB
Delete exhibitors from an event by their IDs.
Inputs: eventId (required), exhibitorIds (required).
swapcard_delete_sessionsB
Delete sessions/plannings from an event by their IDs.
Inputs: eventId (required), planningsIds (required).
swapcard_delete_webhookA
Delete a webhook subscription by its ID.
Inputs: webhookId (required).
swapcard_export_analyticsA
Export raw analytics event records for one or more events. Data has ~10-minute delay. Cursor-paginated.
Inputs: event_ids (required), limit, cursor, events, +5 more.
swapcard_get_custom_fieldsA
Get all custom field definitions for an event, optionally filtered by target entity type.
Inputs: eventId (required), target.
swapcard_get_eventA
Get a single Swapcard event by ID, including title, dates, description, address, groups, community, and stats.
Inputs: eventId (required).
swapcard_get_eventsC
Get multiple Swapcard events by their IDs in one request.
Inputs: eventIds (required).
swapcard_get_my_exhibitorsC
Get the list of exhibitors accessible to the authenticated Leads API token.
Inputs: after, first.
swapcard_get_my_leadsB
Get all leads (scanned contacts) for a specific exhibitor at a specific event.
Inputs: eventId (required), exhibitorId (required).
swapcard_get_select_field_optionsA
Get all Select and MultipleSelect custom field definitions with their option values.
Inputs: eventId (required).
swapcard_import_event_peopleC
Create or update attendees/people in bulk. Supports groups, barcodes, speaker roles, exhibitor memberships, and custom fields.
Inputs: data (required), eventId (required), force, validateOnly.
swapcard_import_sessionsB
Create or update sessions/plannings in bulk. Supports all formats, video types, access control, and custom fields.
Inputs: eventId (required), plannings (required).
swapcard_list_event_documentsC
List all documents attached to an event.
Inputs: eventId (required), page.
swapcard_list_event_peopleA
List or search attendees/people in an event with optional email filter and cursor-based pagination.
Inputs: eventId (required), after, first, emails, +1 more.
swapcard_list_exhibitorsC
List or search exhibitors in a community.
Inputs: communityId (required), sort, after, first, +2 more.
swapcard_list_meetingsA
List meetings in an event with optional ID/date filters and cursor pagination.
Inputs: eventId (required), ids, after, first, +1 more.
swapcard_list_sessionsA
List or search sessions/plannings in a community. Filter by event, format, speaker; sort by various fields.
Inputs: communityId (required), sort, after, first, +2 more.
swapcard_list_webhooksA
List all webhook subscriptions configured for an event.
Inputs: eventId (required).
swapcard_scan_badgesB
Scan attendee badges on behalf of an exhibitor. Optionally set rating (1-5) and note per badge.
Inputs: badges (required), eventId (required), exhibitorId (required).
swapcard_update_custom_fieldC
Update an existing custom field definition.
Inputs: fieldDefinitionId (required), isVisible, isEditable, maxCharacters.
swapcard_update_documentB
Update a community-level document (v2) by its ID.
Inputs: id (required), url, name, description.
swapcard_update_event_documentC
Update an existing event document.
Inputs: documentId (required), url, name, description.
swapcard_update_exhibitorC
Update a single exhibitor's details including features and background image.
Inputs: eventId (required), exhibitorId (required), name, logoUrl, +4 more.
swapcard_update_webhookC
Update an existing webhook subscription's endpoint or event types.
Inputs: webhookId (required), hooks, endpoint.
swapcard_upsert_exhibitorsB
Create or update exhibitors in an event.
Inputs: eventId (required), exhibitors (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 32 tools
Most tools target clearly distinct resources, but there are confusing overlaps: swapcard_create_document vs swapcard_create_event_document and swapcard_update_document vs swapcard_update_event_document are easy to mix up. get_my_exhibitors vs list_exhibitors and upsert_exhibitors vs update_exhibitor also require careful reading.
The swapcard_ verb_noun prefix pattern is consistent, but the verb choice is mixed: get_event/get_events use 'get' while list_event_people/list_sessions/list_exhibitors use 'list'. Pluralization is inconsistent too, with delete_webhook singular but delete_event_documents and delete_custom_fields plural.
32 tools is heavy for even a broad event management server, and the set spans many subdomains including events, people, sessions, exhibitors, documents, webhooks, custom fields, meetings, leads, and analytics. This will overwhelm an agent during tool selection. The count clearly exceeds the 25-tool threshold where coherence tends to degrade.
Core workflows are well covered: people import/list/delete, session list/import/delete, exhibitor list/upsert/update/delete, webhook CRUD, and custom field CRUD. However, events are read-only, meetings only have a list operation, and community-level documents have no list or delete tool, leaving notable lifecycle gaps.
Related MCP Connectors
Enables AI assistants to retrieve event data and execute event management operations in Nunify.
Talk to your live-events CRM (campaigns, analytics, paid ads, segments) in Claude and ChatGPT.
Manage SiteGPT chatbots and account resources through the SiteGPT API v2.
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with the Wisembly API to fetch and manage event data, including event details, participants, organizers, and locations.21ISC
- AlicenseAqualityDmaintenanceEnables AI assistants to search, filter, and analyze Microsoft events (conferences, workshops, webinars) using the Microsoft Events API.42MIT
- AlicenseAqualityDmaintenanceExposes Swagger/OpenAPI API documentation to AI models, enabling exploration, search, and interaction with endpoints, schemas, and execution of API calls.1413 npm2MIT
- AlicenseBqualityDmaintenanceEnables natural language access to the Eventbrite API for creating, managing, and interacting with events, venues, and categories.136 npm4MIT