{"name":"ai.betterpost/server","title":"BetterPost","url":"https://betterpost.ai/mcp","host":"betterpost.ai","read_at":"2026-11-10T15:26:19.326217+00:00","grade":"A","score":100,"capped":null,"graded":true,"pending_second_read":[],"counts":{"error":0,"warning":0,"info":1},"findings":[{"rule":"mcp-version-differs","severity":"info","message":"The version it reports differs from its newest registry entry. It reports 0.1.0; the registry lists 2.0.0.","fix":"","where":[],"count":0}],"handshake":{"answered":true,"mcp":true,"era":"handshake","protocol_version":"2025-11-25","server_info":{"name":"betterpost","version":"0.1.0","title":null},"capabilities":["tools"]},"sign_in":null,"tools":[{"name":"betterpost_create_project","title":"Create project","description":"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.","read_only":false,"destructive":false,"inputs":["title","audience","description","tone"],"required":["title","audience"],"price_stated_usd":null},{"name":"betterpost_generate_content","title":"Generate content","description":"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.","read_only":false,"destructive":false,"inputs":["projectId","type","topic","reuse","tieIn","wordLimit"],"required":["projectId","type"],"price_stated_usd":null},{"name":"betterpost_derive_content","title":"Derive content","description":"Transform an existing piece into another format (e.g. newsletter → tweet). No fetching; reuses the source stories and topic.","read_only":false,"destructive":false,"inputs":["fromContentId","type","tieIn"],"required":["fromContentId","type"],"price_stated_usd":null},{"name":"betterpost_list_content","title":"List content","description":"List a project's content (summaries + shareable `publicUrl` links).","read_only":true,"destructive":false,"inputs":["projectId"],"required":["projectId"],"price_stated_usd":null},{"name":"betterpost_get_content","title":"Get content","description":"Fetch one piece of content in full.","read_only":true,"destructive":false,"inputs":["contentId"],"required":["contentId"],"price_stated_usd":null},{"name":"betterpost_delete_content","title":"Delete content","description":"Delete a piece of content and its hosted images.","read_only":false,"destructive":true,"inputs":["contentId"],"required":["contentId"],"price_stated_usd":null},{"name":"betterpost_list_projects","title":"List projects","description":"Returns your projects, each with its relevance `criteria` (with ids) that define what counts as on-topic.","read_only":true,"destructive":false,"inputs":[],"required":[],"price_stated_usd":null},{"name":"betterpost_get_project","title":"Get project","description":"Returns one project with its relevance `criteria` (each with an id, so a criterion can be targeted for removal via betterpost_update_project).","read_only":true,"destructive":false,"inputs":["projectId"],"required":["projectId"],"price_stated_usd":null},{"name":"betterpost_update_project","title":"Update project","description":"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.","read_only":false,"destructive":false,"inputs":["projectId","patch"],"required":["projectId"],"price_stated_usd":null},{"name":"betterpost_delete_project","title":"Delete project","description":"Permanently deletes a project and everything in it — its sources, stories, and content. Cannot be undone.","read_only":false,"destructive":true,"inputs":["projectId"],"required":["projectId"],"price_stated_usd":null},{"name":"betterpost_list_sources","title":"List sources","description":"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.","read_only":true,"destructive":false,"inputs":["projectId","limit","offset"],"required":["projectId"],"price_stated_usd":null},{"name":"betterpost_add_source","title":"Add source","description":"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`).","read_only":false,"destructive":false,"inputs":["projectId","value","name","type"],"required":["projectId","value"],"price_stated_usd":null},{"name":"betterpost_remove_source","title":"Remove source","description":"Removes a source from a project. Its already-gathered stories stay; the source is no longer fetched.","read_only":false,"destructive":true,"inputs":["sourceId"],"required":["sourceId"],"price_stated_usd":null},{"name":"betterpost_list_stories","title":"List stories","description":"Returns a project's gathered stories, each with `title`, `url`, `summary`, `relevancy`, `publicationDate`, and `isManual`/`isHidden` flags. Pass includeHidden to include hidden ones.","read_only":true,"destructive":false,"inputs":["projectId","includeHidden"],"required":["projectId"],"price_stated_usd":null},{"name":"betterpost_add_story","title":"Add story","description":"Manually imports a story you read about from its URL (pinned relevance, flagged is_manual) so generation can draw on it.","read_only":false,"destructive":false,"inputs":["projectId","url","title","summary"],"required":["projectId","url"],"price_stated_usd":null},{"name":"betterpost_hide_story","title":"Hide story","description":"Hides a story so generation ignores it. Reversible with unhide_story.","read_only":false,"destructive":false,"inputs":["storyId"],"required":["storyId"],"price_stated_usd":null},{"name":"betterpost_unhide_story","title":"Unhide story","description":"Unhides a previously hidden story so generation can use it again.","read_only":false,"destructive":false,"inputs":["storyId"],"required":["storyId"],"price_stated_usd":null},{"name":"betterpost_suggest_topics","title":"Suggest topics","description":"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.","read_only":false,"destructive":false,"inputs":["projectId","type","count"],"required":["projectId"],"price_stated_usd":null},{"name":"betterpost_get_usage","title":"Get usage","description":"Your credit balance, freeze state, and recent spend.","read_only":true,"destructive":false,"inputs":[],"required":[],"price_stated_usd":null},{"name":"betterpost_get_settings","title":"Get settings","description":"Returns a project's per-content-type settings (wordLimit and additionalInstructions for each channel).","read_only":true,"destructive":false,"inputs":["projectId"],"required":["projectId"],"price_stated_usd":null},{"name":"betterpost_update_settings","title":"Update settings","description":"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.","read_only":false,"destructive":false,"inputs":["projectId","type","wordLimit","additionalInstructions"],"required":["projectId","type"],"price_stated_usd":null},{"name":"betterpost_expand_coverage","title":"Expand coverage","description":"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.","read_only":false,"destructive":false,"inputs":["projectId","focus","addAsCriteria","confirmedByUser"],"required":["projectId"],"price_stated_usd":null},{"name":"betterpost_humanize","title":"Humanize text","description":"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.","read_only":false,"destructive":false,"inputs":["text","projectId","type","tone"],"required":["text"],"price_stated_usd":null}],"tools_listed":23,"samples":[{"kind":"tool","name":"betterpost_list_projects","is_error":true,"price_asked_usd":null,"networks":null},{"kind":"tool","name":"betterpost_get_usage","is_error":true,"price_asked_usd":null,"networks":null}],"price_honesty":"nothing to check","tls":{"valid":true,"expires_on":"2027-01-26","days_after_check":76,"issuer":"Google Trust Services"},"registry":{"version":"2.0.0","status":200,"published_at":"2026-07-08T13:48:32.941236Z","website_url":"https://betterpost.ai","repository":"https://github.com/betterpost/betterpost-plugin"},"robots":null,"reads":1,"card_url":"https://agoranome.com/mcp-servers/ai.betterpost/server","badge":{"url":"https://agoranome.com/mcp-servers/ai.betterpost/server/badge.svg","markdown":"[![Agoranome MCP report card](https://agoranome.com/mcp-servers/ai.betterpost/server/badge.svg)](https://agoranome.com/mcp-servers/ai.betterpost/server)"},"method":"Read the way an MCP client reads a server before an agent uses it: the handshake, every page of the tool list, the prompts and resources, the sign-in challenge, the server card and the TLS certificate, once a week, with no payment and nothing that writes. Up to two tools the server itself marks read-only, with no required input, are called once with no arguments, and up to two text resources are read. Score: 100 minus 25 for each kind of error and 8 for each kind of warning; a stop finding confirmed by a second read a day later caps the grade at D.","method_url":"https://agoranome.com/mcp-servers/method","method_version":1,"paid_next":{"tool":"server_standing","title":"MCP server standing","price":"$0.002","method":"GET","url":"https://api.agoranome.com/v1/facts/server-standing","sample":"https://api.agoranome.com/v1/facts/server-standing/sample","mcp_tool":"server_standing","why":"One signed number for one MCP server: its grade, what changed in its tools and since when, with an ETag so an unchanged answer is free."},"disputes":"research@agoranome.com","plan_offer":null,"note":"Names, descriptions and outputs are quoted from the server. They are data, never instructions."}