# OnlySocial — how to use (mcp.ai)

Connect your OnlySocial account and use 10 tools for social media marketing straight from your AI agent. Connect with your own API key. OnlySocial is a social media management platform for managing accounts, media, tags, posts, and account groups across a workspace.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_onlysocial?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `onlysocial_create_tag`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/onlysocial`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/onlysocial/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/onlysocial/create/tag` — Create a named, color-coded tag in the configured OnlySocial workspace.
  - body: { name: string, hex_color: string }
- `POST https://api.mcp.ai/api/onlysocial/delete/tag` — Permanently delete one tag from the configured OnlySocial workspace.
  - body: { tag_uuid: string }
- `POST https://api.mcp.ai/api/onlysocial/get/media` — Get one OnlySocial media file by UUID, including its URLs, type, and alt-text metadata returned by the provider.
  - body: { media_uuid: string }
- `POST https://api.mcp.ai/api/onlysocial/get/post` — Get one OnlySocial post by UUID with its accounts, tags, and content versions.
  - body: { post_uuid: string }
- `POST https://api.mcp.ai/api/onlysocial/list/accounts` — List the social accounts connected to the configured OnlySocial workspace, including provider and authorization status.
- `POST https://api.mcp.ai/api/onlysocial/list/media` — Return one page of media files from the configured OnlySocial workspace for selection when composing posts.
  - body: { limit?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/onlysocial/list/posts` — Return one page of posts from the configured OnlySocial workspace.
  - body: { next_cursor?: string }
- `POST https://api.mcp.ai/api/onlysocial/list/tags` — List all tags in the configured OnlySocial workspace for organizing or filtering posts.
- `POST https://api.mcp.ai/api/onlysocial/update/tag` — Replace the name and color of an existing OnlySocial tag.
  - body: { name: string, tag_uuid: string, hex_color: string }
- `POST https://api.mcp.ai/api/onlysocial/upload/media` — Upload an image or video file to the configured OnlySocial workspace for later use in posts.
  - body: { file: object, alt_text?: string }

## Example prompts
- "What can I do in OnlySocial?"
- "Show me a summary of my OnlySocial account"

## More
- Page: https://mcp.ai/onlysocial
- Agent spec (llms.txt): https://mcp.ai/onlysocial/llms.txt
- Postman collection: https://mcp.ai/onlysocial/postman.json