One server, five doors
Help me get my MCP connected
Local Event Hub is one MCP server at /mcp. Claude, Claude Code, VS Code, ChatGPT, and Microsoft Copilot Studio are five ways in. Each client discovers OAuth settings and registers itself—you do not create an OAuth app by hand.
Tools run as you: search_public_events, get_event, and register_for_event. Paid listings may return needs_checkout so you finish payment in the browser.
Server URL — paste into every door
Loading the server URL…
Create a Local Event Hub account first at Sign in. Connectors RSVP and act only for that user.
Door 1Claude
Claude Connectors call Local Event Hub from Anthropic’s cloud. Paste one URL. Dynamic client registration creates the OAuth client, then the browser asks you to sign in.
Add the connector
- In Claude, open Customize → Connectors → Add custom connector.
- Choose Web and paste the server URL below. Leave OAuth client id and secret blank.
- Save, then Connect. A browser tab opens the Local Event Hub sign-in page.
- Sign in and choose Allow.
- Enable the connector in chat. Ask Claude to search upcoming events near you, open one by id, or RSVP on your behalf.
Door 2Claude Code
The terminal client registers the same URL. The first tool call opens a browser for sign-in. After that, search_public_events, get_event, and register_for_event are available in the session.
Register the server
- From a terminal, run the command in the box below. Add -s project if you want the server in .mcp.json for the repo.
- When the browser opens, sign in to Local Event Hub and choose Allow.
- Run claude mcp list. local-event-hub should report connected.
- Ask Claude Code to list public events, fetch details for one event, or RSVP. Paid events return needs_checkout with a checkout URL.
Door 3VS Code Copilot
VS Code reads the discovery document from the URL. The workspace file is only the server address—no client secret or local callback port.
Add the workspace server
- Save the JSON below as .vscode/mcp.json in your project.
- Open the Command Palette and run MCP: List Servers.
- Start local-event-hub. VS Code fetches OAuth metadata, registers itself, and opens the sign-in page.
- After you allow access, use Copilot Chat or agent mode to search events and RSVP.
Door 4ChatGPT
ChatGPT can connect as an MCP connector (discovery + dynamic registration) or as a custom GPT that imports the OpenAPI document.
Option A — MCP connector
- In ChatGPT, open Settings → Connectors (or Apps) and add a custom connector.
- Paste the server URL below. Use Dynamic client registration; leave client id and secret blank. If discovery fails, choose Retry discovery.
- Continue. Sign in to Local Event Hub and choose Allow.
- Enable the connector in a chat and ask it to find events or RSVP for you.
Option B — custom GPT actions
- Create a GPT and open Configure → Actions → Import from URL.
- Import the OpenAPI document at the actions URL below.
- Set authentication to OAuth with the authorize and token URLs below, scope events.hub, and leave the client secret empty.
- Save and start a conversation. The first action opens the sign-in page.
Door 5Microsoft Copilot Studio
Copilot Studio calls Local Event Hub from Microsoft’s cloud. Use the public server URL above so discovery and dynamic registration work from their network.
Add the MCP tool
- Open copilotstudio.microsoft.com and pick an environment whose data policy allows events.paperiq.ai (or your self-hosted origin).
- Create → New agent, save, then Tools → Add a tool → Model Context Protocol.
- Paste the server URL below. Choose OAuth 2.0 with dynamic client registration; leave client id and secret blank.
- Create the connection, sign in to Local Event Hub, and choose Allow.
- Ask the agent to search public events or RSVP the signed-in user to an event.
If a door fails, check reachability first. A GET to /mcp with no token should return 401—the server is up and waiting for OAuth. A timeout means the URL is wrong or blocked. Dismissing the browser login looks like a dead connector. More detail: docs/mcp-connector.md in the repo.
