# MentionAgent [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/BuildsbyMatt/mentionagent-claude-skill  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mentionagent

## Description
Link building outreach from your agent: review drafts, send the batch, answer publisher replies.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "mentionagent": {
    "url": "https://mentionagent.ai/mcp"
  }
}
```

## Documentation & README

# MentionAgent Claude skill: link building outreach from Claude Code, Cursor, OpenCode and OpenClaw

A Claude Code plugin (and a standalone Agent Skill) that runs [MentionAgent](https://mentionagent.ai) link building outreach from your agent: review the drafts it wrote, send the batch, answer the publishers who replied, and close placements, without opening the dashboard.

It wraps the MentionAgent MCP server (`https://mentionagent.ai/mcp`, 35 tools) with a skill that knows the daily loop, which two tools send real email, which two spend credits, and where to stop and ask you.

Works in Claude Code, Cursor, Windsurf, or any MCP client that can set a request header.

## What it does

- **Triage**: which sites have drafts waiting, which threads need an answer.
- **Draft review in bulk**: reads every pending draft and flags only the ones that look wrong, then edits or discards them.
- **Send once**: approves the batch you have seen.
- **Inbox in one pass**: answers publisher replies, and hands placement proposals to MentionAgent's own reply writer, which crawls the publisher's site and picks the page and paragraph to ask for.
- **Closes the loop**: records a placement as done once the link is live.
- **Campaign changes in plain English**, shown as a plan before anything moves.

## Install as a Claude Code plugin

```
claude plugin marketplace add BuildsbyMatt/mentionagent-claude-skill
claude plugin install mentionagent@mentionagent-claude-skill
```

Then set your API key in the environment the agent runs in:

```
export MENTIONAGENT_API_KEY=ma_live_...
```

The plugin's `.mcp.json` reads `${MENTIONAGENT_API_KEY}`, so the key never lands in a file. Keys are created in the MentionAgent dashboard under Settings, Agent access, and are shown once.

## Install in Cursor

Cursor reads Agent Skills from `.cursor/skills/` (project) or `~/.cursor/skills/` (global), and also from `.claude/skills/` for compatibility. Copy the skill folder in, then add the server to `.cursor/mcp.json`:

```
mkdir -p .cursor/skills
cp -r skills/link-building-outreach .cursor/skills/
```

```json
{
  "mcpServers": {
    "mentionagent": {
      "url": "https://mentionagent.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:MENTIONAGENT_API_KEY}" }
    }
  }
}
```

Type `/link-building-outreach` in the Agent chat to invoke it. Full walkthrough: https://mentionagent.ai/cursor-seo-skill/

## Install in OpenCode

OpenCode reads Agent Skills from `.opencode/skills/` (project) or `~/.config/opencode/skills/` (global), and also from `.claude/skills/` and `.agents/skills/`, so a copy installed for Claude Code or Cursor is already visible. Copy the folder in, then add the server as a remote MCP entry in `opencode.json` and sign in with OAuth (a browser window opens on the MentionAgent consent page):

```
mkdir -p .opencode/skills
cp -r skills/link-building-outreach .opencode/skills/
```

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mentionagent": { "type": "remote", "url": "https://mentionagent.ai/mcp", "enabled": true }
  },
  "permission": {
    "mentionagent_approve_batch": "ask",
    "mentionagent_send_reply": "ask",
    "mentionagent_redirect_thread": "ask"
  }
}
```

```
opencode mcp auth mentionagent
opencode mcp list
```

The `permission` rules matter: OpenCode defaults to `allow` and MCP tools are registered as `mentionagent_<tool>`, so without them the two tools that send email, and `redirect_thread`, which opens a thread to an address taken from an email, run without a prompt. Never start OpenCode with `--auto` in a project that has this server enabled. To use an API key instead of OAuth, set `"oauth": false` on the server and add `"headers": { "Authorization": "Bearer {env:MENTIONAGENT_API_KEY}" }` (OpenCode's substitution syntax is `{env:NAME}`, not `${env:NAME}`). There is no slash command: ask the agent what is waiting on MentionAgent and it loads the skill through its `skill` tool. Full walkthrough: https://mentionagent.ai/opencode-seo-skill/

## Install in OpenClaw

OpenClaw reads Agent Skills from `<workspace>/skills/` and `~/.agents/skills/` (the `SKILL.md` can sit up to six folders deep). Install the folder, register the server, sign in with OAuth (a browser window opens on the MentionAgent consent page), then probe:

```
openclaw skills install ./skills/link-building-outreach
openclaw mcp add mentionagent \
  --url https://mentionagent.ai/mcp \
  --transport streamable-http \
  --auth oauth --no-probe
openclaw mcp login mentionagent
openclaw mcp probe mentionagent
```

To use an API key instead of OAuth, drop `--auth oauth` and pass `--header "Authorization=Bearer ma_live_..."` (the flag takes `KEY=VALUE`; a colon is rejected). `openclaw mcp doctor` will then flag the literal token, which is the reason to prefer OAuth on a shared Gateway. The skill answers to `/link-building-outreach` in any connected channel. Full walkthrough: https://mentionagent.ai/openclaw-seo-skill/

## Install the skill on its own

Copy `skills/link-building-outreach/` into `~/.claude/skills/` (personal) or `.claude/skills/` in a project, then connect the MCP server yourself:

```
claude mcp add --transport http mentionagent https://mentionagent.ai/mcp \
  --header "Authorization: Bearer ma_live_..."
```

Or, in any client that takes a JSON config:

```json
{
  "mcpServers": {
    "mentionagent": {
      "type": "http",
      "url": "https://mentionagent.ai/mcp",
      "headers": { "Authorization": "Bearer ma_live_..." }
    }
  }
}
```

## First run

Ask your agent: *"Connect to MentionAgent and show me what is waiting."* It calls `get_status`, lists your sites, and tells you what it can and cannot do on your behalf.

## What the key can reach

The 35 published tools and nothing else. It cannot see mailbox credentials, billing, domain transfer or account deletion; those stay behind a login. Two tools send email (`approve_batch`, `send_reply`) and both are written to be shown to you first. `send_reply` has no recipient field: the address comes from the thread. The one tool that takes an address is `redirect_thread`. It sends nothing itself, but it opens a thread to that address, and `send_reply` on the new thread writes to it. That address usually comes from an inbound email, so the skill shows it to you, with the sentence it came from, and waits for you to confirm before redirecting. `set_run_settings` with `autoSend: true` lets future batches go out with no review; the skill only sets it when you ask for it.

Full tool reference and limits: https://mentionagent.ai/mcp/

## Files

```
.claude-plugin/plugin.json          plugin manifest
.mcp.json                           the MentionAgent MCP server, key from ${MENTIONAGENT_API_KEY}
skills/link-building-outreach/      the skill (SKILL.md)
```

The canonical copy of this repo lives in the MentionAgent monorepo under `claude-skill/` and is published here on each change.

MIT licensed.