# bamf-mcp

<img src="https://bamf.ai/icons/icon-128.png" width="64" alt="BAMF" />

MCP server for [BAMF.ai](https://bamf.ai): create, schedule and analyze LinkedIn and X content, manage ideas and media, and run outreach, from any AI agent.

This package is a thin stdio bridge to the hosted server at `https://mcp.bamf.ai` (streamable HTTP), built on [mcp-remote](https://github.com/geelen/mcp-remote). All tools run on BAMF's servers.

## Get a key

Create an API key at <https://bamf.ai/settings/api-keys> and export it:

```bash
export BAMF_API_KEY=your_key
```

Without a key, the bridge falls back to the OAuth flow (dynamic client registration, see
`https://mcp.bamf.ai/.well-known/oauth-authorization-server`).

## Install

```bash
npx -y bamf-mcp
```

### Claude Code

```bash
claude mcp add bamf -- npx -y bamf-mcp
# or connect directly over HTTP, no bridge:
claude mcp add --transport http bamf https://mcp.bamf.ai --header "Authorization: Bearer $BAMF_API_KEY"
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.bamf]
command = "npx"
args = ["-y", "bamf-mcp"]
env = { BAMF_API_KEY = "your_key" }
```

### Cursor (`.cursor/mcp.json`)

```json
{ "mcpServers": { "bamf": { "command": "npx", "args": ["-y", "bamf-mcp"], "env": { "BAMF_API_KEY": "your_key" } } } }
```

### Direct HTTP config

```json
{ "mcpServers": { "bamf": { "url": "https://mcp.bamf.ai", "headers": { "Authorization": "Bearer your_key" } } } }
```

## Tool categories

- Posts: generate, draft, edit, preview, publish (LinkedIn and X)
- Scheduling: schedule, pause, resume, unschedule
- Analytics: post, funnel and video analytics summaries
- Ideas: generate, save and list content ideas
- Media: library, folders, carousels, images, video projects
- Outreach: discovery and campaigns (approval-gated)
- Vault: creator context, knowledge docs, memory and search

## Docs

- Agent index: <https://bamf.ai/llms.txt>
- Integration guide: <https://bamf.ai/integrate.md>

## Config

| Env var | Purpose |
| --- | --- |
| `BAMF_API_KEY` | Bearer key sent as `Authorization` |
| `BAMF_MCP_URL` | Override the endpoint (default `https://mcp.bamf.ai`) |

MIT licensed.