MCP server
HappyDTech Poster is a remote Model Context Protocol server. AI assistants use it to schedule and publish social media posts to LinkedIn, TikTok, Instagram and Facebook for you, read analytics and answer comments.
| Server URL | https://poster.happydtech.com/mcp |
|---|---|
| Transport | Streamable HTTP (POST, JSON responses). Protocol versions 2025-06-18, 2025-03-26, 2024-11-05. |
| Sign-in | OAuth 2.1 with PKCE and dynamic client registration (discovered from the 401 response), or an API key as Authorization: Bearer hdp_… |
| Access | Full (acts with your role in the workspace) or read-only. Approval rules of the workspace always apply. |
Connect your AI app
Claude (claude.ai, desktop, mobile)
- Settings → Connectors → Add custom connector.
- Name: HappyDTech Poster. URL:
https://poster.happydtech.com/mcp. - Connect, sign in, choose the workspace and access level, press Allow.
ChatGPT
- Settings → Apps & Connectors → Advanced settings → turn on Developer mode (plans that offer it).
- Create a connector with the server URL and OAuth authentication.
- Sign in and press Allow.
Claude Code
claude mcp add --transport http happydtech-poster https://poster.happydtech.com/mcp
Then run /mcp and choose Authenticate.
Cursor, VS Code and other apps (API key)
Create a key in the app under AI assistants, then add to your MCP settings:
{
"mcpServers": {
"happydtech-poster": {
"url": "https://poster.happydtech.com/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Tools
| Tool | What it does | Changes data |
|---|---|---|
get_workspace | Workspace, your role, connected accounts (account_id), platform status, caption limits. Call first. | No |
list_posts | Upcoming, recent, failed or waiting-for-approval posts with per-platform status and links. | No |
get_post | One post in full. | No |
create_post | Publish now (10-second undo window) or at schedule_at, with per-platform captions, first comment and media. | Yes, public |
update_post | Edit the text of a post that has not gone out. | Yes |
reschedule_post | Move a post to another time. | Yes |
cancel_post | Stop a post where it has not gone out. | Yes |
list_drafts / save_draft | Ideas board: read, or save an idea or draft without publishing. | save: Yes |
list_media | Uploaded videos and images to attach (uploads happen in the web app). | No |
get_analytics | Views, likes, comments, shares per post and per platform; tracked-link clicks. | No |
list_comments / reply_to_comment | Comment inbox (Instagram, Facebook Pages) and public replies. | reply: Yes, public |
create_tracked_links | Short links with UTM tags and click counts. | Yes |
get_posting_times | Research-based best days and hours per platform, with sources. | No |
list_templates | Saved caption templates, hashtag sets and reply snippets. | No |
Times are ISO 8601 with a time zone, for example 2026-11-02T09:00:00+07:00.
Things to ask
- “What is scheduled for next week? Move Thursday’s post to Friday 10:00.”
- “Write three LinkedIn posts about our new service and schedule them Monday, Wednesday and Friday at the best times.”
- “Which posts did best this month, and why?”
- “Reply politely to the open comments asking about price.”
Safety
- The AI never receives your passwords or the platforms’ access tokens; it works through HappyDTech Poster only.
- Each connection belongs to one member and one workspace and is full or read-only. Remove it any time in AI assistants; it stops at once.
- Every change an AI makes, including refused attempts, is listed for the workspace’s owners and admins.
- Limits: 600 MCP calls per connection per hour, plus the app’s normal posting limits.