# BetterPost — agent plugin and skill

Write **timely, well-sourced content** — newsletters, blog posts, LinkedIn posts,
tweets, and Bluesky posts — grounded in current sources across news, social, and the
open web. BetterPost finds recent sources relevant to your product and audience,
ranks them by relevance, and writes human-sounding content with real citations and
publication dates.

Works in the agents you already use, through a single [MCP](https://modelcontextprotocol.io)
server. **Free to start** — sign in with your BetterPost account to get free credits.

## Install

### Any agent

```
npx skills add betterpost/betterpost-plugin
```

This installs the `betterpost` skill into whichever agent you use. It does not
configure the MCP server — the skill walks your agent through registering
`https://betterpost.ai/mcp` the first time you ask for content.

### Claude Code

```
/plugin marketplace add betterpost/betterpost-plugin
/plugin install betterpost@betterpost
```

This installs the skill **and** registers the MCP server for you.

Either way, ask your agent to write a newsletter or post about what's happening in
your space. It sets up a project and generates content grounded in current sources.

## What's in here

- `skills/betterpost/SKILL.md` — the skill your agent invokes.
- `.mcp.json` — registers the hosted BetterPost MCP server.
- `.claude-plugin/` — the plugin manifest and self-listed marketplace.
- `.codex-plugin/`, `.cursor-plugin/`, `.kimi-plugin/`, `.agents/`, `.opencode/`,
  `.pi/`, `gemini-extension.json` — manifests for the other agents.

## Using the server directly

Any MCP client can connect to `https://betterpost.ai` (Streamable HTTP). On first
use, the client prompts you to sign in with your BetterPost account (OAuth 2.1) and
handles the session for you — there's no token to copy or persist. New accounts get
free credits on sign-up.

## Links

- Website: https://betterpost.ai
- Contact: hello@betterpost.ai

## License

MIT