VenuNite Events
Free US local event search. No signup or API key; 90-day lookahead. Paid commercial and bulk access.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http venunite-events 'https://mcp.venunite.com/v1/mcp/' --header 'Authorization: <Optional for search; required for create_ticket_handoff. Supply Bearer followed by your portal-issued vn_live_ key from https://venunite.com/developers/keys. Omit this header for anonymous discovery. Never share the key in a URL.>'
{
"mcpServers": {
"venunite-events": {
"type": "http",
"url": "https://mcp.venunite.com/v1/mcp/",
"headers": {
"Authorization": "<Optional for search; required for create_ticket_handoff. Supply Bearer followed by your portal-issued vn_live_ key from https://venunite.com/developers/keys. Omit this header for anonymous discovery. Never share the key in a URL.>"
}
}
}
}
venunite-eventsclaude mcp add venunite-events -e 'VENUNITE_API_KEY=<your venunite_api_key>' -- uvx venunite-events==0.3.1
{
"mcpServers": {
"venunite-events": {
"command": "uvx",
"args": [
"venunite-events==0.3.1"
],
"env": {
"VENUNITE_API_KEY": "<your venunite_api_key>"
}
}
}
}
متغيرات البيئة
VENUNITE_API_KEYسري Optional VenuNite key. Search works without signup or a key: 30 tool calls/minute, 100/day per retained signed session, 20 results/search, and 90-day lookahead. Anonymous network limits also apply. A free account key provides 30 tool calls/minute and 500/day shared across the account’s keys, with the same search results and lookahead. Create a key at https://venunite.com/developers/keys. Commercial and bulk use require a paid plan. A portal-issued live key is required for create_ticket_handoff. Handoffs require the user to select Continue to seller checkout and do not buy or reserve tickets.
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
VenuNite Events
Find US concerts, comedy, theater, trivia, festivals, community events, and family activities by place, date, interests, and budget. Results include event details and source links. Coverage varies by location.
This repository contains public client configurations for VenuNite's hosted MCP server. Search needs no account, API key, or local server installation. Client subscriptions and model usage are governed by the client provider.
Streamable HTTP endpoint: https://mcp.venunite.com/v1/mcp/
Documentation · Privacy · Service terms · Support
Free personal access and paid use
| Access | Calls/minute | Calls/day | Results/search | Search horizon |
|---|---|---|---|---|
| No signup or key | 30 | 100 per retained signed transport session | 20 | 90 days |
| Optional free account key | 30 | 500 per account, shared across keys | 20 | 90 days |
Anonymous access also has shared-network abuse limits and a 10,000-result-row daily allowance per source IP. Clients must retain the server-issued session to keep a session allowance. Free keys have a 10,000-result-row daily allowance per account. The two access modes use the same event search and coverage.
Commercial products, bulk extraction, and REST API use require the appropriate paid plan. Check the MCP page for current limits and the service terms for permitted use. No signup is required to try personal event search.
Gemini CLI
gemini extensions install https://github.com/isaacaskew/venunite-events
Restart Gemini CLI, then inspect /mcp to confirm discovery. This extension
enables search_events only, so every bundled tool works without credentials.
The manifest follows the Gemini extension format. It connects over HTTP and contains no executable hooks or local server code. Installing it directly does not depend on a gallery listing.
Claude Code
Install the plugin from VenuNite's repository marketplace:
claude plugin marketplace add isaacaskew/venunite-events
claude plugin install venunite-events@venunite
Or add only the hosted connector:
claude mcp add --transport http venunite-events https://mcp.venunite.com/v1/mcp/
See the Claude marketplace documentation. This repository marketplace is separate from approval in the public Claude Directory.
Claude, Perplexity, Grok, Mistral, and other remote MCP clients
In the client's custom connector settings, add the endpoint above and choose no authentication for event search. The client must support Streamable HTTP. Availability depends on the client's plan and administrator settings.
- Claude custom connectors
- Perplexity remote connectors
- Grok custom MCP connectors
- Mistral Vibe Work MCP connectors (administrator setup)
Custom installation does not imply approval or inclusion in a provider's catalog.
GitHub Copilot / VS Code
Merge the mcpServers entry from .mcp.json into your project's
.mcp.json. For the VS Code configuration format, merge
configs/vscode.json into .vscode/mcp.json instead.
Preserve your existing server entries. Start the server using VS Code's MCP
controls and review its tools before use.
Cursor
This repository includes a Cursor plugin manifest at
.cursor-plugin/plugin.json, which connects to
the hosted server without credentials. Marketplace listing requires Cursor's
separate review; the manifest alone does not mean it is listed.
Merge configs/cursor.json into .cursor/mcp.json in
your project or ~/.cursor/mcp.json for your user. Preserve existing entries.
Windsurf / Devin Desktop Cascade
Open the MCP config file from Cascade's Actions menu, then merge the server
entry in configs/cascade.json. The current desktop
documentation calls this product Devin Desktop. Enable the server and review
the tool list in its MCP controls.
Tools and optional authentication
| Tool | What it does | Authentication |
|---|---|---|
search_events | Searches event facts and source links using location, date and interest filters | None, subject to fair-use limits |
create_ticket_handoff | Creates an attributed, preview-safe link for a selected event | A VenuNite live API key |
Clients that discover every server tool will see create_ticket_handoff, but
anonymous calls to it return authentication_required. Search results already
include VenuNite event pages with ticket links when available.
For optional authenticated access, create your own key at
VenuNite developer keys, then configure
your client's secret/header mechanism to send Authorization: Bearer <key>.
Never commit a real key. Gemini users can add an authenticated server in their
own settings if they need the handoff tool; the bundled extension stays keyless.
A handoff does not purchase tickets, reserve inventory, or guarantee availability or final prices. The user reviews its page and explicitly selects Continue before leaving for the external ticket seller. Automated clients must leave that decision to the user.
The server receives tool arguments and connection metadata. Calls record quota and request telemetry. An uncached named location may be sent to the public Nominatim geocoder. The connector does not request whole conversation histories, local files, calendars, or email access.
Try it
- Find live music in Denver this weekend under $30. Include dates and links.
- Find free community events in Denver next weekend.
- Find family-friendly activities in Boulder tomorrow.
Use a specific city and date window. Verify current event details with the linked venue or organizer; an empty search means no matching served events.
Development
The server runs on VenuNite infrastructure; this repository contains only configuration and documentation. Validate the Claude manifests with:
claude plugin validate .claude-plugin/plugin.json --strict
claude plugin validate .claude-plugin/marketplace.json --strict
The configuration files are MIT licensed. The hosted service and event data remain subject to VenuNite's service terms and the original sources' rights.
الأسئلة الشائعة
ما هو VenuNite Events؟
Free US local event search. No signup or API key; 90-day lookahead. Paid commercial and bulk access.
كيف أثبّت VenuNite Events؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http venunite-events 'https://mcp.venunite.com/v1/mcp/' --header 'Authorization: <Optional for search; required for create_ticket_handoff. Supply Bearer followed by your portal-issued vn_live_ key from https://venunite.com/developers/keys. Omit this header for anonymous discovery. Never share the key in a URL.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج VenuNite Events إلى مفتاح API؟
نعم. يتطلب VENUNITE_API_KEY, Authorization، وتضبطها في إعداداته.
هل VenuNite Events مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون VenuNite Events؟
ينشره isaacaskew. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.