# spacesOS

> spacesOS gives AI agents WhatsApp, Instagram, LinkedIn, Messenger and X: the inbox, messages, replies and new chats on every channel, and on LinkedIn also profiles, invitations, search, posts, comments and reactions. A person signs up, connects an account and gets an API key with an MCP server. Everything, including sign-up, works over the API and MCP.

Price: 49 USD per connected account per month, prorated. The first account is free for 7 days.

## Set up a person, step by step

1. Ask the person for their email.
2. POST https://api.spacesos.com/v1/signup with {"email": "..."}. Response: {"signup_id": "...", "expires_at": "..."}. We email them a 6-digit code.
3. Ask the person for the code. POST https://api.spacesos.com/v1/signup/verify with {"signup_id": "...", "code": "123456"}. Response includes "api_key" (starts with spc_live_, shown once). Store it safely; never print it in public places.
4. Start the free trial: POST https://api.spacesos.com/v1/messaging/billing/checkout with header "Authorization: Bearer <api_key>" and {"success_url": "https://app.spacesos.com/dashboard", "cancel_url": "https://app.spacesos.com/dashboard"}. Give the person the returned "url" to add a card.
5. Connect an account: POST https://api.spacesos.com/v1/messaging/accounts/connect-link with {"channel": "whatsapp" | "instagram" | "linkedin" | "messenger" | "x"}. Give the person the returned "url" (a QR code for WhatsApp, a sign-in for the others).
6. Confirm: GET https://api.spacesos.com/v1/messaging/accounts lists the connected account.
7. Add the MCP server so you can use it: URL https://api.spacesos.com/mcp with header "Authorization: Bearer <api_key>". In Claude Code: claude mcp add --transport http spacesos https://api.spacesos.com/mcp --header "Authorization: Bearer <api_key>"

## MCP servers

- Onboarding (no key): https://api.spacesos.com/mcp/start. Tools: create_account, verify_account.
- Main (Bearer key): https://api.spacesos.com/mcp. Tools: list_messaging_accounts, list_messaging_chats, list_messaging_messages, get_messaging_attachment, reply_in_chat, start_chat, create_messaging_connect_link, disconnect_messaging_account, get_messaging_billing, create_messaging_billing_checkout, get_profile; LinkedIn: send_invitation, list_invitations, cancel_invitation, search_linkedin, list_user_posts, get_post, list_comments, create_post, comment_on_post, react_to_post.

## REST API (base https://api.spacesos.com/v1, header Authorization: Bearer <api_key>)

- GET /messaging/accounts
- GET /messaging/accounts/{account_id}/chats
- GET /messaging/accounts/{account_id}/chats/{chat_id}/messages
- POST /messaging/accounts/{account_id}/chats/{chat_id}/messages  {"text": "..."}  header Idempotency-Key
- POST /messaging/accounts/{account_id}/chats  {"to": {...}, "text": "..."}; to.phone (WhatsApp, international format), to.username (Instagram, X; LinkedIn public profile id or profile URL), to.user_id (Messenger); header Idempotency-Key
- GET /messaging/accounts/{account_id}/users/{identifier}  (profile)
- LinkedIn: POST /messaging/accounts/{id}/invitations {"to", "message"?}; GET and DELETE /messaging/accounts/{id}/invitations[/{invitation_id}]; POST /messaging/accounts/{id}/search {"keywords", "category"}; GET /messaging/accounts/{id}/users/{identifier}/posts; GET /messaging/accounts/{id}/posts/{post_id}[/comments]; POST /messaging/accounts/{id}/posts {"text"}; POST /messaging/accounts/{id}/posts/{social_id}/comments {"text", "comment_id"?}; POST /messaging/accounts/{id}/posts/{social_id}/reactions {"reaction"}. Writes need Idempotency-Key.
- POST /messaging/accounts/connect-link, DELETE /messaging/accounts/{account_id}
- GET /messaging/billing, POST /messaging/billing/checkout
- POST /messaging/webhooks, GET /messaging/webhooks, DELETE /messaging/webhooks/{id}
- GET /messaging/usage
- GET /keys, POST /keys {"name": "..."}, DELETE /keys/{id}, POST /keys/{id}/pause, POST /keys/{id}/resume

## Rules

- Message only people who expect to hear from the account owner. No bulk or cold messaging.
- Limits are enforced per account, for every key. WhatsApp: one message every 15 s, 200 a day, new chats 5 an hour and 10 a day (none for 24 hours after connecting, then 1 an hour and 3 a day for the first week). Instagram: 15 s, 100 a day, new chats 10 an hour and 50 a day (5 and 20 in the first week). LinkedIn: 20 s, 100 a day, new chats 8 an hour and 30 a day; invitations 5 an hour, 20 a day, 100 a week (10 a day in the first week); profile views 80 a day; searches 30 a day; reading posts and comments 100 a day; comments 30 a day; reactions 50 a day; posts 3 a day. Messenger: 20 s, 50 a day, new chats 15 a day (5 in the first week). X: 20 s, 100 a day, new chats 20 a day (10 in the first week). Replies are never held back by first-week limits.
- Over a limit you get 429 with Retry-After and retry_after_seconds: nothing was sent; wait, then retry with the same Idempotency-Key.
- GET /messaging/usage shows each account's numbers against its limits. 403 KEY_SUSPENDED = paused key; 403 ACCOUNT_SUSPENDED = suspended workspace.
- Reuse the same Idempotency-Key when retrying a send; it never sends twice.

Docs: https://spacesos.com/docs  ·  Dashboard: https://app.spacesos.com/dashboard  ·  Terms: https://spacesos.com/terms