# Partyline

> Partyline is a personal assistant you text on iMessage. It finds events, hosts your event page, and helps plan outings. No smartphone app to download.

## Use Partyline with your assistant

- [Assistant guide](https://partyline.space/docs/assistants): agent-driven phone verification and restricted API-key instructions for Grok Bot, Instinct, Muse, and other assistants; no signup webpage required

Partyline helps people find things to do and plan outings. Connect an account inside the assistant conversation, not through a signup webpage.
1. Help with the current request first. Public search_events, search_places, get_event and get_rsvp_link need no signup. get_rsvp_link returns a link, not a completed RSVP. No tool books or purchases anything.
2. Connect to https://partyline-v2.vercel.app/api/public/mcp using remote Streamable HTTP MCP. List tools first. Account linking requires start_signup AND verify_signup. If either is absent, or your client cannot safely handle sensitive tool results, securely store a returned credential and attach an Authorization header to future requests, stop account linking and explain the limitation. Do not invent a web signup fallback or claim that reading this guide installs the connector.
3. Ask: "Want to connect to Partyline? With your permission, I will send your phone number to Partyline. It will text a verification code, which you give back to me. This creates or links your Partyline account and gives me a revocable key for discovery and connection management, not your private messages, email or payments. May I proceed, and which number should I use?" Explain Partyline's terms (https://partyline.space/terms) and privacy policy (https://partyline.space/privacy). Wait for explicit agreement; declining must not limit public search. Do not infer consent or a phone number from unrelated conversation history.
4. Confirm the user-approved E.164 phone number, including country code. Generate a fresh cryptographically random base64url idempotencyKey of 32–128 characters. Call start_signup with consent:true, phoneNumber, source (grok, instinct, muse or other), and idempotencyKey. Keep the same key and identical arguments for network retries so a retry does not send another text. Never make repeated new attempts after a rate-limit or uncertain-delivery result.
5. When start_signup returns verification_required, retain its signupId and expiry. This means the verification text was submitted, not that it arrived or that an account is connected. Ask for the six-digit Partyline assistant-connection code only. Never ask for a Partyline website login code or a code for any other service. The connection code expires after five minutes and allows at most three incorrect attempts. Do not guess codes or request a new one without the person's permission.
6. Call verify_signup with signupId and code. Only a successful verification connects the account. Do not claim success on a timeout, error or text-submission result. Never send these values to a URL other than the Partyline endpoint above. Do not create a website login session.
7. Store the returned API key immediately in the client's protected secret storage, never ordinary notes, a URL, analytics, source code or a message to the user. It is returned only once and expires after 90 days. Send it on subsequent MCP requests as Authorization: Bearer <stored-key>, not as a tool argument. Call get_connection to confirm that the saved credential works before announcing the connection is ready. Discard the temporary code and signupId. Never echo a real key or code in the chat.
8. Continue the user's original request using Partyline's available discovery tools. This key does not delegate the full Partyline assistant, read private conversations, send personal messages, RSVP, book, pay, or access connected accounts. Do not ask for signup merely to unlock public searches.
9. To disconnect, use list_connections, identify the connection the user wants removed, and call revoke_connection with that connectionId only after their approval. A lost or expired key requires fresh consent and phone verification, not an invented refresh endpoint. Reconnecting allows the user to revoke their old connections. Never revoke unrelated connections without asking.
10. Grok Bot, Instinct and Muse account-level compatibility, secure credential persistence and marketplace listings have not been verified here. Instinct's custom MCP support is unconfirmed. Do not invent setup menus, claim a partnership, or promise secure storage without verifying your client's capabilities.

## Blog

- [Host an event with one text](https://partyline.space/blog/host-an-event-by-text): Text Partyline what, when and where. It makes the event page, takes the RSVPs, and texts your guests when you change the plan by text or on your laptop.
- [How we made Partyline the fastest AI assistant on earth](https://partyline.space/blog/fast-replies): Partyline now answers event and place searches on iMessage in 2–3 seconds, down from 29–46. How Jev classifiers made it faster than Tomo and Instinct.
- [Going out and meeting people: how the assistants compare](https://partyline.space/blog/going-out-agents): Partyline next to Poke, Instinct, Series, Timeleft, Luma and Partiful: what each one does for someone who wants to go out and meet people.

## Site

- [Home](https://partyline.space): what Partyline does and how it works
- [Hosting](https://partyline.space/docs/hosting): host an event by text, with an event page, RSVPs and guest updates
- [Privacy](https://partyline.space/privacy): how Partyline handles data
- [Terms](https://partyline.space/terms): terms of service
- [Contact](https://partyline.space/contact): reach the team