Skip to content
Back to search

postory-agent

MarketplaceWorks with Claude CodeGitHub

Postory's agent kit: the Postory MCP server, its skill and slash commands.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vadympetryshyn--postory-agent/badge.svg)](/listings/vadympetryshyn--postory-agent)

HTML

<a href="/listings/vadympetryshyn--postory-agent"><img src="/api/listings/vadympetryshyn--postory-agent/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

/plugin marketplace add vadympetryshyn/postory-agent
/plugin install postory@postory-agent

Then sign in once ([above](#sign-in-once)).

Codex

codex plugin marketplace add vadympetryshyn/postory-agent
codex plugin add postory@postory-agent

Then sign in once ([above](#sign-in-once)): `codex mcp login postory`, then a new session. Only the connection, without the plugin: `codex mcp add postory --url https://postory.io/mcp`.

Cursor

Clone the plugin into Cursor's local plugins folder, then restart Cursor (or run **Developer: Reload Window**):

git clone https://github.com/vadympetryshyn/postory-agent ~/.cursor/plugins/local/postory

Only the connection: [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=postory&config=eyJ1cmwiOiJodHRwczovL3Bvc3RvcnkuaW8vbWNwIn0=), or in `~/.cursor/mcp.json`:

{ "mcpServers": { "postory": { "url": "https://postory.io/mcp" } } }

Gemini CLI

gemini extensions install https://github.com/vadympetryshyn/postory-agent

Gemini CLI opens the browser to sign in on first use; `/mcp auth postory` signs in again.

Grok Build

Add `vadympetryshyn/postory-agent` as a plugin marketplace source in Grok Build, then install `postory`.

Any other agent that reads skills

npx skills add vadympetryshyn/postory-agent

The skill needs the Postory connection: add `https://postory.io/mcp` to your agent as a remote (Streamable HTTP) MCP server.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "postory-agent",
  3. "description": "Postory's agent kit: the Postory MCP server, its skill and slash commands.",
  4. "owner": {
  5. "name": "Postory",
  6. "url": "https://postory.io"
  7. },
  8. "plugins": [
  9. {
  10. "name": "postory",
  11. "source": "./",
  12. "description": "Run your social media with AI agents: draft, schedule and publish X, Threads, Bluesky and LinkedIn posts through Postory."
  13. }
  14. ]
  15. }
README.md · README · 160 lines
  1. # Postory plugin for AI coding agents
  2. **Run your social media with your AI coding agent.** This is the plugin that connects
  3. [Postory](https://postory.io) to Claude Code, Codex, Cursor, Gemini CLI, Grok Build and any other agent that reads
  4. skills. Ask in plain words ("write three posts about our launch and schedule them next week") and your agent does it in
  5. your Postory account on X, Threads, Bluesky and LinkedIn: drafts, scheduling, images, your calendar, replies and post
  6. stats. Nothing is published without your yes in the chat.
  7. ## Fastest way: let your agent install it
  8. Open your coding agent and paste this:
  9. ```text
  10. Install the Postory plugin for this agent from https://github.com/vadympetryshyn/postory-agent — follow the install steps for your agent in its README, then tell me how to sign in to Postory.
  11. ```
  12. The agent picks the right commands for itself. When it is done, sign in to Postory in the browser once (the agent tells you
  13. how); you need a free [Postory](https://postory.io) account with your social accounts connected.
  14. ## Sign in once
  15. After the install your agent lists the Postory plugin (or the `postory` server) as needing sign-in or authentication.
  16. That is normal: sign in to Postory once in the browser and pick what your agent may do.
  17. - **Claude Code:** `/mcp` → `plugin:postory:postory` → Authenticate (or ask a Postory question: the agent gives you
  18. the sign-in link).
  19. - **Codex:** run `codex mcp login postory` in a terminal (it opens the browser), then start a new Codex session.
  20. - **Cursor:** Settings → MCP → postory → sign in.
  21. - **Gemini CLI:** `/mcp auth postory`.
  22. - **Any other agent:** sign in to the `postory` MCP server your agent lists as needing authentication.
  23. If you ask a Postory question before signing in, your agent tells you the same step.
  24. ## Where it works
  25. | Your agent | What you get |
  26. |---|---|
  27. | Claude Code | the plugin: Postory connection, skill and slash commands |
  28. | Codex | the plugin: Postory connection and skill |
  29. | Cursor | the plugin: Postory connection, skill and commands |
  30. | Gemini CLI | the extension: Postory connection, skill and context |
  31. | Grok Build | the plugin: Postory connection, skill and commands |
  32. | Any agent that reads skills | the skill, plus the Postory connection you add |
  33. **ChatGPT, Claude.ai and other chat apps do not use this plugin.** They connect with one URL, `https://postory.io/mcp`:
  34. see the step-by-step guides at <https://postory.io/features/mcp>.
  35. ## What is inside
  36. - **The Postory connection:** the hosted server `https://postory.io/mcp` (you sign in to Postory in the browser; no key,
  37. nothing to run locally). It gives your agent the Postory tools.
  38. - **The `postory` skill:** tells your agent which tool to use when, and the rules (nothing goes out without your yes).
  39. - **Four slash commands:** `/postory:plan-week`, `/postory:reply-inbox`, `/postory:weekly-review`, `/postory:daily-brief`.
  40. ## Install, by agent
  41. ### Claude Code
  42. ```sh
  43. /plugin marketplace add vadympetryshyn/postory-agent
  44. /plugin install postory@postory-agent
  45. ```
  46. Then sign in once ([above](#sign-in-once)).
  47. ### Codex
  48. ```sh
  49. codex plugin marketplace add vadympetryshyn/postory-agent
  50. codex plugin add postory@postory-agent
  51. ```
  52. Then sign in once ([above](#sign-in-once)): `codex mcp login postory`, then a new session. Only the connection, without the plugin:
  53. `codex mcp add postory --url https://postory.io/mcp`.
  54. ### Cursor
  55. Clone the plugin into Cursor's local plugins folder, then restart Cursor (or run **Developer: Reload Window**):
  56. ```sh
  57. git clone https://github.com/vadympetryshyn/postory-agent ~/.cursor/plugins/local/postory
  58. ```
  59. Only the connection:
  60. [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=postory&config=eyJ1cmwiOiJodHRwczovL3Bvc3RvcnkuaW8vbWNwIn0=),
  61. or in `~/.cursor/mcp.json`:
  62. ```json
  63. { "mcpServers": { "postory": { "url": "https://postory.io/mcp" } } }
  64. ```
  65. ### Gemini CLI
  66. ```sh
  67. gemini extensions install https://github.com/vadympetryshyn/postory-agent
  68. ```
  69. Gemini CLI opens the browser to sign in on first use; `/mcp auth postory` signs in again.
  70. ### Grok Build
  71. Add `vadympetryshyn/postory-agent` as a plugin marketplace source in Grok Build, then install `postory`.
  72. ### Any other agent that reads skills
  73. ```sh
  74. npx skills add vadympetryshyn/postory-agent
  75. ```
  76. The skill needs the Postory connection: add `https://postory.io/mcp` to your agent as a remote (Streamable HTTP) MCP
  77. server.
  78. ## Update
  79. The Postory connection (tools, prices, rules) is always current; only the skill and the slash commands are copied to your
  80. machine.
  81. - **Claude Code:** `claude plugin marketplace update postory-agent`, then `claude plugin update postory@postory-agent`
  82. (restart the session), or turn on auto-update for it (`/plugin` → Marketplaces → postory-agent → auto-update; off by
  83. default for third-party marketplaces), or keep it current automatically (below).
  84. - **Codex:** `codex plugin marketplace upgrade postory-agent`, then `codex plugin add postory@postory-agent`.
  85. - **Cursor:** `git -C ~/.cursor/plugins/local/postory pull`, then reload the window.
  86. - **Gemini CLI:** `gemini extensions update postory` (or install with `--auto-update`), then restart the session.
  87. - **Grok Build and other agents:** update the plugin or skill the way your agent updates its sources.
  88. ### Claude Code: keep it current automatically
  89. Put this in `~/.claude/settings.json` (or a project's `.claude/settings.json`). Claude Code then refreshes the
  90. marketplace and updates the plugin in the background after startup:
  91. ```json
  92. {
  93. "extraKnownMarketplaces": {
  94. "postory-agent": {
  95. "source": { "source": "github", "repo": "vadympetryshyn/postory-agent" },
  96. "autoUpdate": true
  97. }
  98. },
  99. "enabledPlugins": { "postory@postory-agent": true }
  100. }
  101. ```
  102. ## Without a plugin
  103. The HTTP API (`https://postory.io/docs/api`, a `pst_` key from Postory Settings → API keys) reaches the same operations
  104. with the same permissions, limits and credit prices.
  105. ## For maintainers
  106. This repository is published from the `agent/` folder of Postory's source by `back/scripts/publish_agent_repo.sh`;
  107. change it there. The commands are generated from the server's MCP prompts (`back/app/mcp/prompts.py`) by
  108. `back/scripts/build_agent_bundle.py`; never edit them by hand. After a prompt change, from the source root:
  109. ```sh
  110. docker compose run --rm --no-deps -T -v "$PWD:/out" back python -m scripts.build_agent_bundle --write /out
  111. ```
  112. `back/tests/unit/mcp/test_agent_bundle.py` fails while a command is stale or the manifests disagree (version, server
  113. URL, paths). The publish step stamps every manifest's version `<major>.<minor>.<number of commits touching agent/>`, so
  114. each change reaches installed plugins. Check the Claude Code manifests with `claude plugin validate ./agent`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.