All servers · Audio & speech · Utilities

BetterPost

ai.betterpost/server · v2.0.0

Measured by MCP Station

Description written by the publisher, not verified

Finds timely sources across news, social, and the web and writes posts worth publishing.

Connect

claude mcp add --transport http server https://betterpost.ai/mcp

{
  "mcpServers": {
    "server": {
      "url": "https://betterpost.ai/mcp"
    }
  }
}

Tools as reported by the server

• betterpost_create_project
  Create a content project. Slow, one-shot: infers config (criteria, industry, tone), discovers sources, and gathers/ranks an initial set of timely stories. Best called after the inferred audience, description, and tone have been confirmed with the user, since the config shapes everything downstream.
• betterpost_generate_content
  Generate a new piece of content for a project from its timely, relevant stories. Fast in steady state. Charges credits on success only. If you pass a `topic` the project has no stories about, this returns a `topic_unavailable` error (no charge) carrying an `inScope` flag and next steps — it never si
• betterpost_derive_content
  Transform an existing piece into another format (e.g. newsletter → tweet). No fetching; reuses the source stories and topic.
• betterpost_list_content
  List a project's content (summaries + shareable `publicUrl` links).
• betterpost_get_content
  Fetch one piece of content in full.
• betterpost_delete_content write/delete
  Delete a piece of content and its hosted images.
• betterpost_list_projects
  Returns your projects, each with its relevance `criteria` (with ids) that define what counts as on-topic.
• betterpost_get_project
  Returns one project with its relevance `criteria` (each with an id, so a criterion can be targeted for removal via betterpost_update_project).
• betterpost_update_project
  Updates a project's title, audience, description, tone, freshness window, timezone, or relevance criteria, and returns the updated project with its criteria. Changing title/audience/description re-derives the relevance criteria (replace-all), which broadens or narrows what counts as on-topic. To edi
• betterpost_delete_project write/delete
  Permanently deletes a project and everything in it — its sources, stories, and content. Cannot be undone.
• betterpost_list_sources
  Returns one slimmed page of a project's sources plus project-wide `total` and `counts` (ok/failing/disabled/pending, and byType). Page with `limit` (default 50) and `offset`, following the returned `nextOffset` until it is null.
• betterpost_add_source
  Adds a source to a project and fetches it immediately (bounded by a few seconds), returning `storiesAdded` so the next generate_content can use it; if it is still fetching it returns `fetched:false` with a note. Doubles as manual source import: paste any URL (RSS/Atom feed, article, or a page, profi
• betterpost_remove_source write/delete
  Removes a source from a project. Its already-gathered stories stay; the source is no longer fetched.
• betterpost_list_stories
  Returns a project's gathered stories, each with `title`, `url`, `summary`, `relevancy`, `publicationDate`, and `isManual`/`isHidden` flags. Pass includeHidden to include hidden ones.
• betterpost_add_story
  Manually imports a story you read about from its URL (pinned relevance, flagged is_manual) so generation can draw on it.
• betterpost_hide_story
  Hides a story so generation ignores it. Reversible with unhide_story.
• betterpost_unhide_story
  Unhides a previously hidden story so generation can use it again.
• betterpost_suggest_topics
  Clusters a project's current stories into a few candidate angles — each with a label, how many stories back it, and example headlines — and warms the project (gathers and ranks fresh stories) in the process. Returns topics you can offer the user before generate_content.
• betterpost_get_usage
  Your credit balance, freeze state, and recent spend.
• betterpost_get_settings
  Returns a project's per-content-type settings (wordLimit and additionalInstructions for each channel).
• betterpost_update_settings
  Patches one content type's wordLimit and/or additionalInstructions (free-form writing guidance for that type; pass an empty string to clear it). Project-wide preferences (title/audience/tone, project-wide additionalInstructions) live on betterpost_update_project.
• betterpost_expand_coverage
  Broadens a project's coverage: expands the relevance criteria (when needed), finds more sources across news, the web, and the relevant social platforms, and fetches them inline. Applies on a `topic_unavailable`, `no_stories`, or low-coverage signal. May return `warming: true` with `retryAfterMs` (~6
• betterpost_humanize
  Rewrite existing text into BetterPost's readable, human voice. Preserves the meaning, facts, links, and format; returns the rewritten text plus short notes on what changed. Pass `projectId` to write in that project's tone and instructions, `type` to apply a channel's style, or `tone` to set the voic

Repository · Website · JSON · Text for agents · Registry updated 2026-07-08