Skip to content
SocialGTM logoSocialGTM
Sign upGo to dashboard

SocialGTM MCP server

SocialGTM runs a remote MCP server. Any client that speaks Streamable HTTP and the MCP authorization spec can connect without an API key: it registers itself, sends you to log in, and gets a token for your workspace.

Connect it

  1. Point your client at the server URL:
    https://socialgtm.app/api/mcp
  2. When it asks you to sign in, log in to SocialGTM and choose Allow. The connection works in the workspace you had open.

No API key. You sign in with your SocialGTM account, and the connection works in the workspace you had open when you allowed it.

What you need

Streamable HTTP transport and OAuth 2.1 with PKCE. Clients register themselves through dynamic client registration (RFC 7591) and find the endpoints through protected resource metadata (RFC 9728) and authorization server metadata (RFC 8414).

What to ask

  • “Call get_overview, then list_drafts for Reddit, and show me each draft next to the post it answers.”
  • “Go through my pending Reddit drafts. Reject any that read like an ad and tell me why.”

Read and write tools

5 of the 9 tools only read and carry readOnlyHint: true. approve_draft and reject_draft are marked destructiveHint: true, and write_reply and dismiss_match change state without being destructive. Clients that confirm writes use these hints, so a well-behaved client asks before approving anything.

Scopes and workspaces

A token reaches one workspace: the one you had open in SocialGTM when you chose Allow.

What it can do

It reads your queue, drafts, matches and mentions, and can write, approve or reject replies, under the same reply limits and safety holds as the SocialGTM app. On X, Reddit and LinkedIn you still post each reply yourself. See everything it can do.

The tools

  • get_overview: Counts of drafts and matches by platform. Read-only.
  • list_drafts: Reply drafts waiting for review. Read-only.
  • get_draft: One draft, with the post it answers and why the agent picked it. Read-only.
  • list_matches: Possible matches from the last few days. Read-only.
  • list_mentions: Mentions of your brand and competitors, tagged. Read-only.
  • write_reply: Draft a reply to a match or a mention. Changes your queue.
  • dismiss_match: Hide a post that doesn't fit. Changes your queue.
  • approve_draft: Approve a reply, as written or edited. Changes your queue.
  • reject_draft: Reject a reply, with a reason the agent learns from. Changes your queue.

If it doesn’t connect

  • A request without a token gets a 401 whose WWW-Authenticate header points at https://socialgtm.app/.well-known/oauth-protected-resource/api/mcp. If your client doesn't follow it, check that it supports MCP authorization.
  • Access tokens last an hour. Clients that ask for offline_access get a refresh token and stay signed in.

Setup steps follow MCP specification: authorization.

Other AI apps

Plans start at $9 a month. Create your agent, then connect it.