# socializioz-chatgpt-mcp

Remote MCP server for the Socializioz ChatGPT app integration.

This server exposes a controlled, approval-safe Socializioz tool surface to ChatGPT. It lets authenticated users inspect their workspace context, connected social accounts, draft posts, manage approval workflow, and schedule or cancel scheduled content.

## Purpose

The MCP server is designed for the Socializioz ChatGPT app submission.

It acts as a thin bridge between ChatGPT and the Socializioz production backend. Business logic stays inside Socializioz/Base44 backend functions. The MCP layer handles:

- MCP protocol transport
- Authentication resolution
- Tool registration
- Input/output validation
- Safe forwarding to backend bridge functions
- Health/status endpoints for deployment verification

## Safety scope

Phase 1 is intentionally limited.

Allowed:

- Read authenticated user profile
- Read workspace context
- Read brand profile
- Read connected social accounts
- Create draft posts
- Read posts
- Update draft posts
- Send posts for approval
- Schedule existing posts
- Reschedule scheduled posts
- Cancel scheduled posts

Not allowed in Phase 1:

- Direct publishing without approval
- Deleting posts
- Managing campaigns
- Uploading or modifying media assets
- Reading analytics
- Managing billing or subscriptions
- Connecting/disconnecting social accounts from ChatGPT

## Backend modes

The server supports two backend modes:

### Base44 mode

Used for the current Socializioz production app bridge.

Registered tools:

1. `get_user_profile`
2. `get_workspace_context`
3. `get_brand_profile`
4. `list_connected_accounts`
5. `create_draft_post`
6. `list_posts`
7. `get_post`
8. `update_draft_post`
9. `send_post_for_approval`
10. `schedule_post`
11. `reschedule_post`
12. `cancel_scheduled_post`

### Supabase mode

Legacy / fallback mode with a smaller phase-1 tool surface.

Registered tools:

1. `get_user_profile`
2. `list_connected_accounts`
3. `create_draft_post`
4. `list_scheduled_posts`
5. `schedule_post`
6. `reschedule_post`
7. `cancel_scheduled_post`

## Architecture

```text
ChatGPT MCP client
  -> /.well-known/oauth-protected-resource
  -> OAuth / bearer authentication
  -> /mcp
      -> AuthResolver
      -> Socializioz MCP tools
      -> Base44 or Supabase bridge functions
      -> Socializioz backend