BetterPost
Finds timely sources across news, social, and the web and writes posts worth publishing.
| Endpoint | https://betterpost.ai/mcp (streamable-http) |
|---|---|
| Registry version | 2.0.0 |
| Now | 23 tools · grade C (69) · pin ts_efa50d9406e3188cfcda9b438d18a9de · protocol 2025-06-18 |
| First / last listed | 2026-11-02 03:20 UTC / 2026-11-02 03:20 UTC |
| Grade over time | 2026-11-02: C (69), 23 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: betterpost_create_project betterpost_generate_content betterpost_derive_content betterpost_list_content betterpost_get_content betterpost_delete_content betterpost_list_projects betterpost_get_project betterpost_update_project betterpost_delete_project betterpost_list_sources betterpost_add_source betterpost_remove_source betterpost_list_stories betterpost_add_story betterpost_hide_story betterpost_unhide_story betterpost_suggest_topics betterpost_get_usage betterpost_get_settings betterpost_update_settings betterpost_expand_coverage betterpost_humanize
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. params: title*, audience*, description, tone |
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 silently writes an off-topic piece. params: projectId*, type*, topic, reuse, tieIn, wordLimit |
betterpost_derive_content | Transform an existing piece into another format (e.g. newsletter → tweet). No fetching; reuses the source stories and topic. params: fromContentId*, type*, tieIn |
betterpost_list_content | List a project's content (summaries + shareable `publicUrl` links). params: projectId* |
betterpost_get_content | Fetch one piece of content in full. params: contentId* |
betterpost_delete_content | Delete a piece of content and its hosted images. params: contentId* |
betterpost_list_projects | Returns your projects, each with its relevance `criteria` (with ids) that define what counts as on-topic. params: none |
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). params: projectId* |
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 edit criteria incrementally instead, pass `patch.addCriteria` (texts to append) and/or `patch.removeCri params: projectId*, patch |
betterpost_delete_project | Permanently deletes a project and everything in it — its sources, stories, and content. Cannot be undone. params: projectId* |
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. params: projectId*, limit, offset |
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, profile, or post on a supported platform) and leave `type` as autodetect, or create a recurring keyword s params: projectId*, value*, name, type |
betterpost_remove_source | Removes a source from a project. Its already-gathered stories stay; the source is no longer fetched. params: sourceId* |
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. params: projectId*, includeHidden |
betterpost_add_story | Manually imports a story you read about from its URL (pinned relevance, flagged is_manual) so generation can draw on it. params: projectId*, url*, title, summary |
betterpost_hide_story | Hides a story so generation ignores it. Reversible with unhide_story. params: storyId* |
betterpost_unhide_story | Unhides a previously hidden story so generation can use it again. params: storyId* |
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. params: projectId*, type, count |
betterpost_get_usage | Your credit balance, freeze state, and recent spend. params: none |
betterpost_get_settings | Returns a project's per-content-type settings (wordLimit and additionalInstructions for each channel). params: projectId* |
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. params: projectId*, type*, wordLimit, additionalInstructions |
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` (~60s), meaning the newly gathered stories are still landing. An out-of-scope `focus` requires `confirm params: projectId*, focus, addAsCriteria, confirmedByUser |
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 voice directly. params: text*, projectId, type, tone |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.