# Indiebob

> Indiebob is a freemium MCP server for marketing and seo. Let an agent read project metrics, publish posts and run personalised cold outreach. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://www.indiebob.com/docs/agents
- **MCP Registry name:** io.github.chemic/indiebob
- **Categories:** marketing and SEO, sales and CRM
- **Listing updated:** 2026-11-15

## About

Everything runs from a scoped service key (ib_sk_) with no browser session. The key carries read and write scopes for projects, metrics, actions, content and outreach, and a missing scope returns a 403 naming it, so an agent can say exactly what to add. One key reaches every project on the account, and plan limits still apply.

On the content side an agent can create a markdown draft and publish it, which snapshots the body, assigns the OG image and fires the webhook that pushes the post to mirrored sites. On the outreach side it can enrol up to 200 prospects in a sequence where each email is written per prospect from their own website, read the review queue, rewrite or skip a message, and approve a first touch. Approving does not send; the send window, daily cap and sending account still decide.

The next_actions tool returns a deterministic ranked Do Next feed with no model involved. Billing, key creation, project creation and settings stay in the browser. The server is a local stdio process installed from npm, or as a Claude Desktop extension.

## Features

- **Scoped agent keys:** Service keys with separate read and write scopes and an expiry; missing scopes return a named 403.
- **Metrics snapshots:** Daily MRR, visitors, signups, revenue and health per project, pulled by date window.
- **Ranked next actions:** A deterministic Do Next feed across the portfolio, each item with why it fired.
- **Post publishing:** Create markdown drafts and publish them to trigger propagation to mirrored sites.
- **Personalised outreach:** Enrol prospects in sequences where Bob writes each email from the prospect's website.
- **Review queue controls:** Read, rewrite, regenerate, skip or approve first-touch emails.
- **Prospect discovery:** Find businesses from OpenStreetMap and look up addresses a business publishes itself.

## Good for

- Have an agent publish a weekly blog post to a project
- Pull MRR and signup snapshots into a report
- Enrol a list of local businesses in a cold-email sequence
- Review and approve queued first-touch emails
- Ask what to do next across several indie projects

## Install

### Claude Code (Terminal)

```sh
claude mcp add indiebob --env INDIEBOB_API_KEY='<INDIEBOB_API_KEY>' -- npx -y @indiebob/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "indiebob": {
      "command": "npx",
      "args": [
        "-y",
        "@indiebob/mcp"
      ],
      "env": {
        "INDIEBOB_API_KEY": "<INDIEBOB_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "indiebob": {
      "command": "npx",
      "args": [
        "-y",
        "@indiebob/mcp"
      ],
      "env": {
        "INDIEBOB_API_KEY": "<INDIEBOB_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "indiebob": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@indiebob/mcp"
      ],
      "env": {
        "INDIEBOB_API_KEY": "<INDIEBOB_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "indiebob": {
      "command": "npx",
      "args": [
        "-y",
        "@indiebob/mcp"
      ],
      "env": {
        "INDIEBOB_API_KEY": "<INDIEBOB_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "indiebob": {
      "command": "npx",
      "args": [
        "-y",
        "@indiebob/mcp"
      ],
      "env": {
        "INDIEBOB_API_KEY": "<INDIEBOB_API_KEY>"
      }
    }
  }
}
```

## Tools

- `whoami`: Confirm the key is live and list its scopes.
- `list_projects`: List the key owner's projects with health, stage and settings.
- `read_metrics`: Daily snapshots per project: MRR, visitors, signups, revenue, health.
- `next_actions`: Ranked Do Next feed across the portfolio.
- `list_posts`: List blog posts with status and SEO score.
- `get_post`: One post with markdown body and SEO fields.
- `create_post`: Create a draft post from markdown.
- `publish_post`: Publish or re-publish a post.
- `list_prospects`: List outreach prospects for a project.
- `list_sequences`: List sequences with status and enrolment counts.
- `enroll_prospects`: Enrol up to 200 prospects in a sequence.
- `list_review_queue`: Personalised first touches awaiting approval.
- `read_message`: One email as it will read, with site context.
- `rewrite_message`: Replace the personalised subject, opening or bridge.
- `regenerate_message`: Discard the personalised parts so the writer starts over.
- `skip_message`: Cancel an email and remove the prospect from the sequence.
- `read_sequence`: One sequence with steps, settings and pace.
- `sequence_stats`: Sent, opened, replied and bounced counts.
- `update_sequence`: Start or pause a sequence or change its pace.
- `create_sequence`: Create a new draft personalised sequence.
- `add_prospect`: Add one prospect an agent found.
- `find_address`: Find the address a business publishes on its own site.
- `start_discovery`: Find businesses on OpenStreetMap.
- `discovery_status`: Check a discovery run.
- `list_senders`: List sending accounts for a project.
- `use_indiebob_mail`: Give a project an IndieBob Mail sending account.
- `approve_message`: Approve one personalised first touch.

## FAQ

### What credentials are needed?

An IndieBob agent key (ib_sk_...) created in Settings, Developers, Agent keys, set as INDIEBOB_API_KEY.

### Can an agent change billing or create projects?

No. Billing, key minting, project creation and settings stay in the browser.

### Does approving an email send it?

No. The sequence's send window, daily cap and sending account still decide when it leaves.

### What does the free plan include?

One project, 3 blog drafts and 5 social batches a month, with outreach through IndieBob Mail and OpenStreetMap prospects.

### Is Indiebob free?

Indiebob has a free plan, with paid plans for more usage or features.

### How do I add Indiebob to Claude Code?

Run this command in your terminal: claude mcp add indiebob --env INDIEBOB_API_KEY='<INDIEBOB_API_KEY>' -- npx -y @indiebob/mcp

### What are the best alternatives to Indiebob?

The closest alternatives to Indiebob are Google Ads + Meta Ads + SEO/GEO MCP, Calven, CompanyData, MisarReach MCP Server and NeuralVerge.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.

---
Source: https://ai-powered.com/mcp/indiebob
