About TopicForge MCP
TopicForge MCP is a server for programmatic SEO workflows, aimed at teams generating and managing articles in batches. It provides topic research, metadata and FAQ generation, and article job management through TopicForge.
Key features
- 01Expand topics into article ideas
- 02Generate FAQ questions and FAQPage JSON-LD
- 03Create meta descriptions
- 04Launch and track batch jobs
- 05Fetch and export articles
- 06Read and update generation settings
Use cases
- 01Develop article ideas from a seed topic
- 02Create FAQ schema and page metadata
- 03Generate articles through batch jobs
- 04Review or export generated articles
MCP support
The MCP server exposes TopicForge topic, content generation, batch job, article, and workspace settings operations as tools for MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @topicforge/mcpTOPICFORGE_API_KEYSecretTopicForge API key (tf_live_...) from https://topicforge.net/app/settings/api-keysCONTENT_API_BASE_URIOptional API base URL (default https://api.topicforge.net)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
9Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| seedTopic | string | Yes | Seed topic to expand into a cluster |
| industry | string | No | Optional industry or vertical |
| topicCount | integer | No | Number of article topics to generate (default 20) |
| string | No | Optional email for follow-up |
Details
From the project README@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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.