BetterPost
Server Details
Finds timely sources across news, social, and the web and writes posts worth publishing.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- betterpost/betterpost-plugin
- GitHub Stars
- 0
- Server Listing
- BetterPost
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 23 tools
Every tool has a clearly distinct purpose—project management, source and story handling, content generation, settings, and usage—with no overlapping functionality. The descriptions clearly delineate when to use each tool.
All tools follow the consistent pattern 'betterpost_<verb>_<noun>', making the set predictable and easy to navigate. The naming convention is uniform throughout.
With 23 tools, the server covers a comprehensive content generation workflow without being overwhelming. Each tool serves a necessary function, and the count feels well-scoped for the domain.
The tool surface covers the full lifecycle of project management, source acquisition, story curation, content generation/derivation, and settings configuration. There are no obvious gaps that would cause an agent to fail in typical use cases.
Available Tools
23 toolsbetterpost_add_sourceAdd sourceAInspect
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, profile, or post on a supported platform) and leave type as autodetect, or create a recurring keyword search by setting value to the search terms and type to a search kind (see type).
Inputs: value (required), projectId (required), name, type. Returns: note, source, fetched, storiesAdded
betterpost_add_storyAdd storyAInspect
Manually imports a story you read about from its URL (pinned relevance, flagged is_manual) so generation can draw on it.
Inputs: url (required), projectId (required), title, summary. Returns: storyId
betterpost_create_projectCreate projectAInspect
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.
Inputs: title (required), audience (required), tone, description. Returns: tone, reason, warming, criteria, +5 more
betterpost_delete_contentDelete contentADestructiveIdempotentInspect
Delete a piece of content and its hosted images.
Inputs: contentId (required). Returns: deleted
betterpost_delete_projectDelete projectADestructiveIdempotentInspect
Permanently deletes a project and everything in it — its sources, stories, and content. Cannot be undone.
Inputs: projectId (required). Returns: deleted
betterpost_derive_contentDerive contentAInspect
Transform an existing piece into another format (e.g. newsletter → tweet). No fetching; reuses the source stories and topic.
Inputs: type (required), fromContentId (required), tieIn. Returns: type, topic, content, summary, +5 more
betterpost_expand_coverageExpand coverageAInspect
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 (~60s), meaning the newly gathered stories are still landing. An out-of-scope focus requires confirmedByUser: true; without it, it returns a confirmation_required error. No credits are charged.
Inputs: projectId (required), focus, addAsCriteria, confirmedByUser. Returns: warming, retryAfterMs, sourcesAdded, storiesAdded, +1 more
betterpost_generate_contentGenerate contentAInspect
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 silently writes an off-topic piece.
Inputs: type (required), projectId (required), reuse, tieIn, +2 more. Returns: type, topic, content, summary, +5 more
betterpost_get_contentGet contentARead-onlyInspect
Fetch one piece of content in full.
Inputs: contentId (required). Returns: id, type, content, summary, +7 more
betterpost_get_projectGet projectBRead-onlyInspect
Returns one project with its relevance criteria (each with an id, so a criterion can be targeted for removal via betterpost_update_project).
Inputs: projectId (required). Returns: id, tone, title, status, +10 more
betterpost_get_settingsGet settingsARead-onlyInspect
Returns a project's per-content-type settings (wordLimit and additionalInstructions for each channel).
Inputs: projectId (required). Returns: contentTypeSettings
betterpost_get_usageGet usageARead-onlyInspect
Your credit balance, freeze state, and recent spend.
Inputs: no named parameters. Returns: kind, frozen, creditBalance, recentSpendUsd
betterpost_hide_storyHide storyAIdempotentInspect
Hides a story so generation ignores it. Reversible with unhide_story.
Inputs: storyId (required). Returns: hidden, storyId
betterpost_humanizeHumanize textAInspect
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 voice directly.
Inputs: text (required), tone, type, projectId. Returns: text, changes, inputWords, creditsCharged
betterpost_list_contentList contentCRead-onlyInspect
List a project's content (summaries + shareable publicUrl links).
Inputs: projectId (required). Returns: content
betterpost_list_projectsList projectsARead-onlyInspect
Returns your projects, each with its relevance criteria (with ids) that define what counts as on-topic.
Inputs: no named parameters. Returns: projects
betterpost_list_sourcesList sourcesARead-onlyInspect
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.
Inputs: projectId (required), limit, offset. Returns: limit, total, counts, offset, +3 more
betterpost_list_storiesList storiesARead-onlyInspect
Returns a project's gathered stories, each with title, url, summary, relevancy, publicationDate, and isManual/isHidden flags. Pass includeHidden to include hidden ones.
Inputs: projectId (required), includeHidden. Returns: stories
betterpost_remove_sourceRemove sourceADestructiveIdempotentInspect
Removes a source from a project. Its already-gathered stories stay; the source is no longer fetched.
Inputs: sourceId (required). Returns: removed
betterpost_suggest_topicsSuggest topicsAInspect
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.
Inputs: projectId (required), type, count. Returns: topics, projectId
betterpost_unhide_storyUnhide storyAIdempotentInspect
Unhides a previously hidden story so generation can use it again.
Inputs: storyId (required). Returns: hidden, storyId
betterpost_update_projectUpdate projectAInspect
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 edit criteria incrementally instead, pass patch.addCriteria (texts to append) and/or patch.removeCriteria (criterion ids from get_project/list_projects). Dates default to US Eastern unless a timezone (an IANA name like "America/New_York") is set.
Inputs: projectId (required), patch. Returns: id, tone, title, status, +10 more
betterpost_update_settingsUpdate settingsAIdempotentInspect
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.
Inputs: type (required), projectId (required), wordLimit, additionalInstructions. Returns: updated
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Music-industry news scored for your brand, with a drafted post in your voice.
Plan, write, convert and publish content to blogs, social channels and wikis.
1Write posts in your voice from what's going viral in your niche. Schedule to X, LinkedIn and more.
Find viral posts, outliers, hooks and ads on Instagram, TikTok, YouTube and Facebook, then write.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables finding trending content across social networks and scheduling/publishing posts with full lifecycle management.92 npmMIT
- FlicenseNot gradedqualityCmaintenanceEditorial intelligence MCP server that helps agents discover stories worth writing about by analyzing primary sources, ranking angles, and turning signal into publishable drafts.-
- AlicenseAqualityDmaintenanceAI content generation, repurposing, and multi-platform publishing for 9+ social media platforms. Generate blog posts, discover trending topics, brainstorm titles, and publish to Twitter, LinkedIn, Bluesky, and more.863 npm7MIT

@orchyn/mcpofficial
AlicenseAqualityAmaintenanceEnables AI assistants to read and analyze real social posts across eight networks, research creators and trends, and generate hooks, draft scores, variants, and repurposed content.27MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.