Postatron MCP server
2026년 11월 10일 커밋AI 클라이언트가 X, Instagram, LinkedIn, TikTok, YouTube와 같은 플랫폼에 걸쳐 소셜 미디어 게시물을 예약, 게시 및 측정할 수 있도록 합니다.
다른 이름 henrwal/postatron-cli, postatron-cli
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.15.1
- 마지막 커밋
- 2026년 11월 10일
- 라이선스
- MIT
Postatron MCP란?
Postatron은(는) MCP server입니다. AI 클라이언트가 X, Instagram, LinkedIn, TikTok, YouTube와 같은 플랫폼에 걸쳐 소셜 미디어 게시물을 예약, 게시 및 측정할 수 있도록 합니다.
프로젝트 README에서 생성된 요약
Postatron MCP server 정보
Postatron은 개발자와 AI agent가 X, Instagram, LinkedIn, TikTok, YouTube를 포함한 다양한 플랫폼에서 소셜 미디어 활동을 관리할 수 있는 방법을 제공합니다. 사용자는 콘텐츠를 예약하고, 연결된 여러 계정에 동시에 게시물을 올리며, 분석 기능을 통해 성과를 모니터링할 수 있습니다. 이 시스템은 올바른 프로필 찾기, 시간대 계산, 플랫폼별 제한 사항 준수와 같은 복잡한 워크플로우를 처리하도록 설계되었습니다.
사용자는 api.postatron.com에 호스팅된 원격 MCP server를 통해 연결하거나, API key와 postatron-mcp 바이너리를 사용하여 stdio 기반의 로컬 MCP server를 실행할 수 있습니다. Claude Desktop, Claude Code, Cursor, Gemini CLI와 통합이 가능합니다. 원격 연결 인증에는 OAuth 2.1이 사용되며, 로컬 설정에는 스코프가 지정된 API key가 필요합니다. 또한 직접적인 프로그래밍 제어를 위한 CLI 및 REST API를 제공합니다.
활용 사례
- 1멀티 플랫폼 게시물 예약AI agent가 단일 콘텐츠를 가져와 LinkedIn과 X에 특정 시간에 게시되도록 예약할 수 있습니다.
- 2소셜 미디어 성과 모니터링개발자가 특정 기간 동안의 참여 데이터 요약을 요청할 수 있습니다.
- 3콘텐츠 큐 자동화사용자가 콘텐츠가 자동으로 공개될 특정 시간대를 설정할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Postatron MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Postatron MCP 설치
$ claude mcp add --transport http postatron-cli https://api.postatron.com/mcpCursor에 Postatron MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"postatron-cli": {
"url": "https://api.postatron.com/mcp"
}
}
}VS Code에 Postatron MCP 설치
.vscode/mcp.json
{
"servers": {
"postatron-cli": {
"type": "http",
"url": "https://api.postatron.com/mcp"
}
}
}VS Code CLI에 Postatron MCP 설치
$ code --add-mcp '{"name":"postatron-cli","type":"http","url":"https://api.postatron.com/mcp"}'Codex에 Postatron MCP 설치
$ codex mcp add postatron-cli --url https://api.postatron.com/mcpCodex config.toml에 Postatron MCP 설치
~/.codex/config.toml
[mcp_servers.postatron-cli] url = "https://api.postatron.com/mcp"
Gemini CLI에 Postatron MCP 설치
$ gemini mcp add -s user --transport http postatron-cli https://api.postatron.com/mcpGemini settings.json에 Postatron MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"postatron-cli": {
"url": "https://api.postatron.com/mcp",
"type": "http"
}
}
}구성
POSTATRON_API_KEY
| 이름 | 설명 | 유형 |
|---|---|---|
| POSTATRON_API_KEY | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능henrwal/postatron-cli is public and reachablegithub.com/henrwal/postatron-cli ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-10github.com/henrwal/postatron-cli ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기postatron-cli
Command line client and MCP server for Postatron, a social media scheduler that publishes one post to every platform you have connected.
This repository holds everything you need to drive Postatron from a terminal or from an AI agent. The service itself is closed source.
cmd/postatron- the CLI.cmd/postatron-mcp- a local MCP server over stdio, for clients that cannot reach a remote one.apiv1- a Go client for the REST API, and the request and response types the API itself is built on.
Connect Claude (no install)
Postatron hosts its MCP server at:
https://api.postatron.com/mcp
In Claude, Postatron is in the connector directory: Settings → Connectors → Browse connectors, find Postatron and click Connect, or open https://claude.ai/directory/postatron. Or add it by hand as a custom connector (Settings → Connectors → Add custom connector) with the URL above. Either way, sign in to Postatron when asked.
Claude Code: install the plugin, which connects the server and adds the Postatron skill in one step.
/plugin install postatron --marketplace henrwal/postatron-cli
Run it inside Claude Code in a terminal (v2.1.275 or later); it asks to add the Postatron marketplace, then installs.
The Claude desktop app has no /plugin command: there, add the connector URL above instead.
Then run /mcp and sign in to Postatron.
To connect the server alone, without the skill:
claude mcp add --transport http postatron https://api.postatron.com/mcp
Cursor: install the Postatron plugin from the Cursor Marketplace once it is listed, or add the server with one click: Add to Cursor. Cursor signs you in to Postatron the first time it uses it.
Gemini CLI: install the extension, which connects the server and adds the Postatron skill, then sign in.
gemini extensions install https://github.com/henrwal/postatron-cli
Then run /mcp auth postatron in Gemini CLI.
Any client that supports remote MCP servers with OAuth 2.1 and dynamic client registration works the same way. There is no key to copy: the client registers itself and you approve it on a Postatron consent page.
Agent skill
npx skills add henrwal/postatron-cli
Installs the postatron skill into Claude Code, Codex, Cursor and the other agents the skills CLI supports.
In Claude Code the plugin above already includes it.
It teaches the agent the workflow behind a request such as "schedule this to LinkedIn and X tomorrow at 9am": find the right profile, work out the time in your timezone, respect each platform's limits, attach media and confirm before anything is published.
It works through the MCP tools when they are connected, and through the CLI or REST otherwise.
Install the CLI
Download a binary for your platform from Releases, or build from source with Go 1.23 or newer:
go install github.com/henrwal/postatron-cli/cmd/postatron@latest
go install github.com/henrwal/postatron-cli/cmd/postatron-mcp@latest
Get an API key
Create one at postatron.com/dashboard/api. Keys are scoped, and the key is shown once at creation. The API, the MCP server and the CLI are included on every paid plan.
export POSTATRON_API_KEY=ptn_your_key_here
POSTATRON_API_URL overrides the API host if you need it to.
Use the CLI
postatron create-post --content "Shipping today." --platforms x,linkedin
postatron create-post --content "Out on Friday." --platforms x --scheduled-at 2026-09-12T09:00:00Z
postatron create-post --content "New in store" --platforms instagram --profile Acme --media-urls https://example.com/shoe.jpg
postatron list-posts --status scheduled
postatron get-post <id>
postatron delete-post <id>
postatron delete-posts <id> <id>
postatron update-post <id> --add-platforms instagram
postatron retry-post <id>
postatron list-events --range 24h --status error
postatron list-accounts
postatron connect-account instagram --profile Acme
postatron list-profiles
postatron create-profile "Acme Ltd"
postatron create-connect-session --profile "Acme Ltd" --platforms instagram --redirect-url https://app.example.com/connected
postatron list-queues
postatron create-queue --name "Weekday mornings" --timezone Europe/London --slots "mon 09:00,wed 09:00"
postatron create-post --content "Whenever there's room" --platforms x --queue "Weekday mornings"
postatron get-usage
postatron get-analytics --range 7d
postatron create-upload --purpose "photo for Tuesday"
postatron get-upload <id>
postatron webhooks create --url https://example.com/webhooks/postatron --events post.failed,post.partial
postatron webhooks test <id>
Add --json to any command for the raw API response.
Full reference in docs/cli.md.
When a post fails
Every failed delivery carries an error_code that says what to do: reconnect (sign the account in again with connect-account --account-id, or connect_account over MCP), rate_limited, platform_unavailable and postatron (retry), media_rejected and validation (make a new post with the change), policy and unknown (read the message).
retry-post (retry_post) sends the post again to the accounts it failed on, never to one it already reached, and is not charged again.
list-events (list_events) reads the same log as the dashboard's Logs page.
Webhooks
A webhook POSTs a signed JSON event to your own server when a post publishes, partly publishes or fails, and when an account is connected, disconnected or needs reconnecting.
Set one up in the dashboard, with POST /v1/webhooks or with postatron webhooks create, and check each request's Postatron-Signature with its secret; docs/api.md has the rules and a Go, Node and Python check.
Profiles
A profile groups connected accounts, usually one per brand or client, and holds at most one account per platform.
Everyone has a Default profile; paid plans can add more.
Pass --profile (CLI) or profile (API and MCP) to post as one brand.
When a platform has accounts in more than one profile, posting by platform without a profile is refused rather than sent to every brand at once.
Local MCP server
For clients that only launch local servers, postatron-mcp exposes the same tools over stdio with an API key.
Claude Desktop, in claude_desktop_config.json:
{
"mcpServers": {
"postatron": {
"command": "postatron-mcp",
"env": { "POSTATRON_API_KEY": "ptn_your_key_here" }
}
}
}
Details in docs/mcp.md.
OpenAPI
The REST API is described in OpenAPI 3.1 at api.postatron.com/v1/openapi.json, webhooks included, and fetching it needs no key.
Use it to generate a client in any language, or hand it to an agent; in Go the same document is apiv1.OpenAPI.
Documentation
- docs/api.md - REST API reference, auth, rate limits, errors.
- apiv1/openapi.json - the OpenAPI 3.1 description the API serves.
- docs/mcp.md - MCP tools and client setup.
- docs/cli.md - every command and flag.
Licence
MIT. See LICENSE.
Postatron MCP 질문
Postatron MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http postatron-cli https://api.postatron.com/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Postatron MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
원격 MCP server의 인증 방식은 어떻게 되나요?
server는 OAuth 2.1 및 dynamic client registration을 사용합니다. client가 스스로를 등록하면 Postatron 동의 페이지에서 연결을 승인하면 됩니다.
Postatron을 로컬에서 사용할 수 있나요?
네, API key를 사용하여 postatron-mcp 명령어로 stdio를 통해 로컬 MCP server를 실행할 수 있습니다.
게시물 전달에 실패하면 어떻게 해야 하나요?
에러 코드를 확인하십시오. 예를 들어 'reconnect'는 계정 재로그인이 필요하며, 'retry'는 retry-post 명령어를 사용할 수 있습니다.