TopicForge/topicforge-mcp
📇 ☁️ - Programmatic SEO batch jobs for agents: runbatch, getbatchstatus, exportmarkdown, plus topic cluster, FAQ schema, and meta description tools. Pay per article, no subscription. Install: npx -y @topicforge/mcp.
Quick Install
{
"mcpServers": {
"topicforge-topicforge-mcp": {
"command": "npx",
"args": [
"-y",
"topicforge-topicforge-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
@topicforge/mcp
Official MCP server for TopicForge — programmatic SEO batch jobs and growth tools.
Install
npm (recommended)
npx -y @topicforge/mcp
Create an API key at topicforge.net/app/settings/api-keys.
Claude Desktop / Cursor
{
"mcpServers": {
"topicforge": {
"command": "npx",
"args": ["-y", "@topicforge/mcp"],
"env": {
"TOPICFORGE_API_KEY": "tf_live_..."
}
}
}
}
Claude Code
claude mcp add topicforge -e TOPICFORGE_API_KEY=tf_live_... -- npx -y @topicforge/mcp
One-click install buttons and more clients: topicforge.net/developers
Environment
| Variable | Required | Description |
|---|---|---|
TOPICFORGE_API_KEY | Yes | Workspace API key |
CONTENT_API_BASE_URI | No | API base (default https://api.topicforge.net) |
Tools
| Tool | Description |
|---|---|
topic_cluster | Expand a seed topic into 15–25 article ideas |
faq_schema | FAQ questions + FAQPage JSON-LD |
meta_description | 150–160 char meta description |
run_batch | Launch a credit-debited batch job (pay per article) |
get_batch_status | Poll batch job progress |
get_article | Fetch article by ID |
export_markdown | Export article as markdown |
get_generation_settings | Read workspace voice profile, product facts, and effective settings |
update_generation_settings | Update workspace generation settings used by run_batch |
Pricing
Pay per article — $10 single, volume packs from $3.99/article. Pricing
Development
This repo is a public mirror of the MCP package in the TopicForge monorepo. To build from source:
npm install
npm run build
npm start
Release tarball (fallback install):
npx -y https://topicforge.net/mcp/topicforge-mcp-1.0.0.tgz
Links
- Smithery: https://smithery.ai/servers/topicforge/topicforge-mcp
- Developer docs: https://topicforge.net/developers
- MCP server card (tool metadata): https://topicforge.net/.well-known/mcp/server-card.json
- OpenAPI: https://topicforge.net/openapi.json
- MCP registry name:
net.topicforge/mcp