Docs

Quickstart

From your project URL to posts in your voice in about five minutes.

1 · Connect your platforms

  • Telegram: add @postmine_bot as a channel admin, then enter your @channelname in Connections. We verify the bot’s rights automatically.
  • Dev.to: paste an API key from dev.to → Settings → Extensions. Articles publish as drafts by default, with your canonical_url preserved.
  • X, LinkedIn: one-click OAuth. We detect X Premium for the 25K character limit and warn you 7 days before any token expires. Threads connects the same way once it clears review (coming soon).

Connecting Telegram, step by step

Telegram is the quickest channel to connect. PostMine posts through a shared bot, @postmine_bot, that you add to your own channel as an admin. You never share a password, and you can remove the bot whenever you like.

  • 1. Open or create a channel: In Telegram, use an existing channel or create one (menu → New Channel). Both public and private channels work.
  • 2. Add @postmine_bot as an admin: Open your channel → Administrators → Add Admin and pick @postmine_bot. Or use the "Add @postmine_bot to my channel" button in Connections, which pre-selects the channel and the post right for you.
  • 3. Keep the Post messages right on: That single permission lets the bot publish your posts. It cannot read your other chats or change your settings.
  • 4. Connect it in PostMine: Back in Connections, type your public @channelname and hit Verify & connect. For a private channel, click scan for it and choose it from the list. We verify the bot’s rights automatically.

Why admin rights? Telegram only lets channel admins post. The Post messages right is the minimum @postmine_bot needs to publish on your behalf, nothing more.

A short walkthrough video is coming here soon.

More on channels and admins is in Telegram’s official help.

2 · Draft, adapt, post

Open New post, write your source text in any language, toggle the platforms, hit Adapt. Edit any variant by hand, counters are live. Then Post now or schedule a time. Each platform is an independent target with its own status and Retry.

3 · Tone of voice

PostMine learns how you write from your connected accounts. One click in Settings and it reads your recent posts to build a tone profile from your sentence length, emoji habits, structure and phrasing. No samples to paste. Every variant is then written in that voice, within each platform’s format.

Prefer a ready-made voice? Pick one of 8 presets, globally in Settings or per post in the composer:

  • My tone: detected from your postsmine
  • Building in public: candid progress notes, numbers, no hype
  • Expert: calm, precise, no emoji
  • Casual friend: warm, contractions, light emoji
  • Hype launch: high energy, short punches
  • Minimalist: fewest words that work
  • Storyteller: scene first, lesson second
  • Educator: step by step, examples
  • Contrarian: Challenges the common take. Leads with the unpopular opinion, backs it with specifics, never hedges.

In the composer, the tone selector sits above Adapt, and every variant card has its own tone chip to override a single platform. Change either and the variants re-adapt in the new voice. Switching tone marks existing variants stale, the same way editing the source does.

4 · Post from your AI assistant (MCP)

Create a key in MCP and register the server in your client:

claude-code: setup
$ claude mcp add postmine \ --transport http https://postmine.tech/api/mcp \ --header "Authorization: Bearer pm_sk_…" ✓ tools: publish_post · adapt_text

Tools: publish_post(text, platforms[], scheduleAt?, tone?) and adapt_text(text, platforms[], tone?).

The optional tone parameter takes a preset id (e.g. expert, hype, minimal) or mine for your detected voice. Omit it to use your default tone.

Keys and access: an MCP key acts on your own workspace; call list_workspaces to see it. Every MCP tool needs an active Pro subscription, on Free the tools return a billing notice instead of running.

Limits cheat-sheet

  • X: 280 (or 25,000 with Premium), URLs count as 23 chars
  • LinkedIn: 3,000
  • Telegram: 4,096, image caption 1,024 (handled automatically)
  • Dev.to: no hard limit, max 4 lowercase tags
  • Tone of voice: 8 presets, or mine for your detected voice, optional per request

Posting limits and frequency

PostMine has no daily cap of its own: publish as much as you need. We only respect each platform’s official API limits, so a post never silently fails and your account stays in good standing.

PlatformOfficial API limit
Xper-app and per-user rate limits
Telegram~20 messages / minute (flood limit)
Dev.toshort publish burst, then throttled
  • LinkedIn reach drops when you post more than once a day. The composer warns you right on the LinkedIn target so you can space posts out.
  • Bans come from spam behavior (mass duplicates, auto-DMs, bot bursts), not from posting volume through official APIs at a normal pace.

Account safety

  • No auto-posting: every variant is approved by you, nothing publishes without your action or a schedule.
  • No DM, comment, follow or engagement automation.
  • Official platform APIs only, never browser automation.
  • No verbatim blasting: each platform gets its own adapted variant.
  • Scheduled posts fire with a small random offset, up to 2 minutes, so they do not look machine-fired.

Plans and billing

Free to start, or Pro at $49/mo. Pro unlocks every connected platform, reply opportunities on Reddit and Hacker News, winner-mining and the premium project docs.

  • Pay yearly and save 20%: $470 upfront, an effective $39/mo.
  • A card is required when you upgrade to Pro. Cancel in one click anytime in Billing.

See the full billing terms for refunds and cancellation.

Questions go to support@postmine.tech