How VarynForge works, page by page.
Every page has a markdown twin at its own URL plus .md, and the whole set is indexed in /llms.txt for your agent.
Getting started
- What VarynForge is: the vocabulary, from project to published articleEvery noun in VarynForge, learned once: project, niche, asset, research run, opportunities, competitors, suggestion, brief, channels, the lint gate and publishing.
- Connect your agent: one endpoint, any MCP host, sign in onceThe VarynForge MCP address, the exact install step for Claude Desktop, Claude Code, Cursor, VS Code and Codex, what the first sign-in does, and what your agent calls first.
- Your first project: from a URL to a writer-ready brief in one sessionCreate a project from a URL or a sentence, know when the niche is ready, and take one idea to a downloadable brief on the free plan, in a single session.
- Free and paid: what Free Forge runs, what a run costs, the capsWhat Free Forge includes, the daily brief cap and what still works past it, the caps on lint_draft and check_idea, what a paid research run adds, and how a wall reads.
Workflows
- The data-backed path: a research run, ranked clusters, a content planWhat a research run does and costs, how opportunity clusters rank and filter, the levers that reshape them, and how a run becomes a content plan with briefs.
- From your own ideas: score it, accept it, check it against live searchScore an idea against your niche with expand_idea, commit it with accept_idea, or bring a full spec, then check it against live search with check_idea. Works on free.
- From the market radar: rising topics the keyword pipeline cannot seeWhat a radar snapshot holds, when the radar is lit and refreshed, and how your agent turns a rising topic into briefs with list_radar_topics, expand_radar_topic and add_radar_topic.
- Drafting and verification: your agent writes, the gate checks itHow your agent drafts from a brief with the channel writer prompt, checks the draft with lint_draft, reads verdicts for free, and keeps the board truthful while it works.
- Publishing and attestation: your CMS publishes, VarynForge recordsWhy VarynForge ships no publish connectors, the three-step flow of publish, verify and record, and what mark_article_published and register_derived_asset do.
- Five channels: one brief, one process, one submission shape eachThe five VarynForge channels, article, x, linkedin, reels and youtube: what each brief holds, how each piece is produced, what lint_draft receives and where the live URL is recorded.
- Organizations and teams: one plan, shared credits, members and rolesHow organizations hold projects, plans, credits and limits, the three roles and what each can do, and how your agent targets and labels work across organizations.
- Client reports: the starting-point report and the pitch reportThe two client-ready reports for agencies and consultants: the free starting-point report from setup data, and the pitch report a completed research run produces.
The app
- The Desk: the articles that need a decision from you nowWhat the Desk lists, which pipeline states put an article on it, every action on its cards and the idea box, and the MCP tools that do the same work.
- The Dashboard: your whole portfolio of projects on one screenWhat the cross-project Dashboard counts, where each number comes from, the controls it offers, and the MCP tools that return the same read to your agent.
- The Radar: a card deck for triaging rising topics one at a timeWhat the Radar screen deals, what lit, dormant and preview cards mean, what Keep, Dismiss and Later do, and the MCP tools behind each card.
- The Library: every article across your projects, in one tableWhat the Library table lists, how age in state and the stuck flag are worked out, its filters and sorting, and the MCP tool that returns the same rows.
- Earnings: Search Console clicks by article and by sourceWhat the Earnings screen counts, how Search Console data reaches it and how fresh it is, what the sample preview means, and what your agent can do over MCP.
- Project Overview: where a project stands and what to do nextWhat the project Overview shows before, during and after a research run, where its numbers come from, every control on it, and the MCP tools that read the same state.
- Opportunities: the ranked topic clusters a research run foundHow the Opportunities board and the cluster page rank, filter and show coverage, what Forge brief and Dismiss do, and the MCP tools that read and shape the same clusters.
- Content Plan: every article from brief to published, by statusThe Content Plan board and its eight status columns, the article page with its briefs, drafts, gate receipts and timeline, the controls on both, and their MCP equivalents.
- The Report screen: a client-ready report for every projectWhat the Report screen shows before and after a research run, where each section comes from, the markdown and PDF downloads, and the re-sync dialog.
- The Prompts screen: project-aware prompts for any chat assistantThe eight prompt templates on the Prompts screen, the project data that fills them, how to use them in ChatGPT, Claude or Gemini, and how they relate to MCP.
- The Queries screen: every keyword a research run foundThe Queries list and keyword detail: intent, demand bucket and difficulty per keyword, the pages ranking for it, and the matching list_keywords and get_keyword_detail.
- The Pages screen: your pages and the competitor pages that rankThe Pages list and page dossier: owned versus competitor pages, exploitability, target keywords and rankings, and the matching list_pages and get_page_dossier.
- The Companies screen: who competes with you for searchThe Companies list and company detail: competition type, relevance, importance and what it changes, adding a competitor by domain, and the matching MCP tools.
- Research History: every research run on a project, past and liveWhat a row on Research History shows, how a live run is tracked, what happens to a failed run and its credit, how to start another, and the MCP calls that do the same.
- Settings: your account, billing, notifications and organizationThe account half of Settings in the web app: your profile and sign-in email, the Billing screen and Stripe, the Notifications screen, and where organization members live.
- Project settings: niche, competitors, destinations and indexingThe Project half of Settings: the niche and posting cadence, important and ignored competitors, where you publish, IndexNow pings and the read-only Search Console grant.
Reference
- MCP tools: every tool the VarynForge server exposes, by categoryThe full VarynForge MCP tool list by category, which calls are free, capped or spend a credit, and the habits that keep your agent fast and cheap.
- Entitlement walls: what a blocked tool returns and whyEvery wall the VarynForge MCP server can return, the entitlement payload field by field, and how your agent should handle one without retrying.
- Suggestion statuses: the eight stages and what moves eachEvery article suggestion status, what moves a suggestion into it, who sets it, how the gate and publish detect move it, and which board column shows it.
- Account and data: what VarynForge keeps, and who sees itWhat VarynForge stores for your account, your organization and each project, who can open a project, what leaves during a run or a connection, and how deletion works.