Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TryPost

TryPost for Grok Build

Draft, preview, schedule and publish social media posts without leaving your terminal. Ship a release, then announce it — in the same session.

Supports LinkedIn, X, Bluesky, Instagram, Threads, Mastodon, TikTok, YouTube, Pinterest, Facebook, Telegram and Discord through TryPost.

Install

grok plugin install trypostit/trypost-grok-plugin --trust

--trust matters. Grok blocks a plugin's MCP server until the plugin is trusted, and an untrusted install gives you the skills with none of the tools — which looks exactly like a broken plugin. If you installed without it, press e on the plugin in /plugins.

First run

Type /trypost and Grok opens a browser to authorize against TryPost. On the consent screen you pick which workspace this connection acts on — the grant is bound to that one workspace, so pick deliberately if you manage several. To switch later, authorize again.

You need a TryPost account with an active subscription or trial. Without one every call returns 402; start at app.trypost.it.

Before authorizing, grok mcp doctor trypost reports healthy: false with OAuth authorization required. That is expected, not a fault.

Use it

> /trypost we shipped dark mode, here's the changelog entry

Working in Acme Marketing.

Draft created for LinkedIn and X. Here is what each will receive:

LinkedIn:
  Dark mode is here. Flip it on in Settings → Appearance — your eyes
  will thank you at 11pm.

X:
  Dark mode shipped. Settings → Appearance. That's it.

Nothing has been posted. Want me to schedule or publish it?

Nothing publishes until you say so. From here you can ask for changes ("drop the emoji"), or move it forward:

> schedule it for tomorrow at 9am

Scheduled for LinkedIn and X — tomorrow, 9:00 AM. It will go out on its
own; nothing else to do.

That last message is a real confirmation to schedule, not a vague "looks good" — the agent needs one before it calls update-post-tool with status: "scheduled", the same as it would before publishing outright.

/trypost-accounts    what this workspace can post to
/trypost-queue       what is scheduled to go out

To attach a screenshot or a demo clip from the repo, just say so — the agent uploads the local file and attaches it.

What is in here

Path What it is
skills/trypost Order of operations, media upload, failure handling, and the map of all 31 MCP tools
skills/writing-social-posts How the copy should read on each network
commands/trypost-accounts, commands/trypost-queue Read-only status commands
.mcp.json Points at the hosted TryPost MCP server

The plugin ships no runtime code. It is a pointer to https://app.trypost.it/mcp/trypost plus the instructions that make an agent good at using it.

Publishing is deliberate

The agent always previews before publishing and always asks first. This is not politeness: published posts cannot be unpublished on most networks, and on TikTok there is no delete endpoint at all — a mistake can only be removed by hand in the app.

Self-hosted TryPost

The plugin points at TryPost Cloud. Running your own instance? Point Grok at it directly:

grok mcp add --transport http trypost https://your-host/mcp/trypost

Development

python3 scripts/verify.py

Asserts the manifest validates, all four entries load as invocable skills, and the MCP server is configured to point at Cloud — a string comparison against the installed manifest, not a network call. Requires the grok CLI on PATH and grok login already done.

The script installs the plugin globally (writing to ~/.grok/installed-plugins) to exercise the real install path, then uninstalls it again in a finally block. If you already have this plugin installed, running it will remove your install; reinstall afterwards.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages