# Spaces > Spaces is a messaging API and an MCP server. An agent reads and sends messages for the person who connected the account. Channels: Instagram (DMs, comments, and a private reply from a comment into a DM when the platform allows it), WhatsApp (more than one number, each connected with a QR code), LinkedIn, Messenger, Telegram, and one-to-one email on Gmail, Outlook, and IMAP. Brand name: Spaces. Domains stay spacesos.com, app.spacesos.com, and api.spacesos.com. ## Plans No contact limits and no per-contact overage on any plan. - Free: $0, no card. 1 connected account. 500 agent actions a month, then a hard stop. An agent action is a billable API or MCP call that reads or writes (list, get, send, comment, react, invite, search, workflow step). Auth, health, and billing calls are not actions. - Paid: $49 a month for the first connected account and $29 a month for each extra account. A card starts a 14-day trial, or 30 days when a trial code is applied. The card is charged when the trial ends. The subscription renews automatically. Yearly is 20% off: $470.40 for the first account and $278.40 for each extra. Each paid account includes 5,000 agent actions a month, pooled across the workspace, then $1 per extra 1,000 actions. The customer can set a monthly spend cap. Spaces emails at 80% and at 100% of the allowance. - Agencies: one subscription, quantity is connected accounts the agency pays for. $29 per account a month for 1 to 19 accounts, $24 for 20 to 49, $19 for 50 or more. Minimum 5 accounts. A referred customer who pays their own plan can be attributed to the agency. The agency earns 30% of that subscription for its lifetime, after refunds and chargebacks, approved 30 days after payment. Payouts are manual. If connect returns BILLING_REQUIRED, the workspace is not on an active plan yet. Start checkout, or stay on Free within the one-account and 500-action limits. ## Addresses - REST: https://api.spacesos.com/v1 - MCP (Bearer key): https://api.spacesos.com/mcp - Onboarding MCP (no key): https://api.spacesos.com/mcp/start - This file: https://www.spacesos.com/llms.txt and https://api.spacesos.com/llms.txt and https://app.spacesos.com/llms.txt - Longer copy: https://www.spacesos.com/llms-full.txt and https://api.spacesos.com/llms-full.txt - Docs: https://www.spacesos.com/docs and https://www.spacesos.com/docs/agents - OpenAPI: https://www.spacesos.com/openapi.json and https://api.spacesos.com/openapi.json - Discovery: https://www.spacesos.com/.well-known/mcp.json and https://api.spacesos.com/.well-known/mcp.json - Health: https://api.spacesos.com/health Auth: API keys start with spc_live_ and are sent as Authorization: Bearer. MCP uses the same header. The onboarding server does not use a key. ## Set up a person 1. Ask for their email. 2. POST https://api.spacesos.com/v1/signup with {"email":"..."}. Response: signup_id, expires_at. Spaces emails a 6-digit code. 3. POST https://api.spacesos.com/v1/signup/verify with {"signup_id":"...","code":"123456"}. Response includes api_key (spc_live_, shown once). Store it. Do not print it in public. 4. Paid trial: POST https://api.spacesos.com/v1/messaging/billing/checkout with Authorization: Bearer and {"success_url":"https://app.spacesos.com/dashboard","cancel_url":"https://app.spacesos.com/dashboard"}. Give the person the returned url. Checkout collects a card. The trial is 14 days, or 30 days with a trial code. Do not connect a paid account before checkout finishes. 5. Connect: POST https://api.spacesos.com/v1/messaging/accounts/connect-link with {"channel":"whatsapp"|"instagram"|"linkedin"|"messenger"|"telegram"|"x"|"gmail"|"outlook"|"imap"}. Give the person the url. WhatsApp and Telegram use a QR code. The others are a sign-in, including a second factor when the platform asks for one. Call it again for another account. Each WhatsApp number is its own account. 6. GET https://api.spacesos.com/v1/messaging/accounts and confirm the account. 7. Add the MCP server: claude mcp add --transport http spaces https://api.spacesos.com/mcp --header "Authorization: Bearer " ## What an agent can do - List accounts, list the inbox, list chats, read messages, download attachments (images, files, voice, video, GIFs), reply, and start a chat. - Instagram: DMs through the chat tools. Comments and a private reply from a comment into a DM when the platform allows that reply. - LinkedIn: profile, invitation, search, posts, comments, reactions. - Email: list, read, send, and reply on one thread, with attachments. No bulk send. - Workflows: sequences of LinkedIn, Instagram, WhatsApp, and Telegram steps, with delays, stop when the person replies, and the same per-account send limits as a normal message. - Webhooks for new messages. Safety limits are enforced on every key. Over a limit the answer is 429 with retry_after_seconds. Nothing was sent. Wait, then retry with the same Idempotency-Key. - Message only people who expect to hear from the account owner. No bulk or cold messaging. ## Account safety Spaces reduces ban risk with enforced limits, warm-up, pacing and auto-pause. It cannot guarantee the platform will not restrict the account. Do not work around a limit. On 429, wait retry_after_seconds and retry with the same Idempotency-Key. If the account is paused, stop. Check GET https://api.spacesos.com/v1/messaging/usage or the MCP tool get_messaging_usage before bulk work. A send returns account_safety with remaining_today, remaining_this_week, paused and reason. ## Safety limits (per account) WhatsApp: 15 seconds between messages, 200 a day, new chats 5 an hour and 10 a day. No new chats for 24 hours after connecting, then 1 an hour and 3 a day in week one. The ramp lasts four weeks. Instagram: 15 seconds, 80 a day, new chats 6 an hour and 20 a day (2 an hour and 8 a day in week one). LinkedIn: 20 seconds, 100 messages a day, new chats 8 an hour and 30 a day (8 a day in week one). A normal message is for a 1st-degree connection. inmail true sends an InMail. A connection request with a note is send_invitation. Invitations 5 an hour, 20 a day, 100 a week (5 a day in week one). Profile views 80 a day. Searches 30 a day. Comments 30 a day. Reactions 50 a day. Posts 3 a day. Messenger: 20 seconds, 40 a day, new chats 3 an hour and 8 a day (1 an hour and 3 a day in week one). Telegram: 20 seconds, 80 a day, new chats 5 an hour and 20 a day (8 a day in the first week). X: 20 seconds, 100 a day, new chats 5 an hour and 20 a day (6 a day in week one). Gmail, Outlook, IMAP: 20 seconds, 80 a day, 40 new threads a day. One email at a time. No warm-up ramp. Replies in an existing chat are not held by the warm-up. The same cold text cannot be sent to many people. If someone says stop, later sends in that chat are refused. A restricted or checkpoint account cannot send until it is reconnected. Docs for people: https://www.spacesos.com/docs Docs for agents: https://www.spacesos.com/docs/agents Full tool list: https://www.spacesos.com/llms-full.txt