VarynForge LogoLogin
MCP server

Read your site.
Forge your next ten articles.

VarynForge exposes its full SEO workflow as MCP tools. Connect once from Claude Desktop, Cursor, Claude Code, or any MCP host — then ask your agent to set up a project, hand it your article ideas, and forge writer-ready briefs the host agent uses as its writing prompt.

Connect free Install snippets

57 tools · OAuth-secured · Free tier: 10 briefs / day

60-second install

Pick your host. Connect once.

One endpoint, four hosts. OAuth handles the rest.

Claude Desktop

Built-in Connectors UI — no config file needed

  1. 1Open Claude Desktop → Settings → Connectors
  2. 2Click Add custom connector
  3. 3Paste the URL: https://app.varynforge.com/api/mcp
Or paste this into claude_desktop_config.json
{
  "mcpServers": {
    "varynforge": {
      "url": "https://app.varynforge.com/api/mcp"
    }
  }
}

→ On first tool call, your browser opens; sign in once.

Claude Code

Run once in any terminal

claude mcp add --transport http varynforge https://app.varynforge.com/api/mcp

→ On first tool call, your browser opens; sign in once.

Codex

OpenAI Codex CLI + IDE extension

codex mcp add varynforge --url https://app.varynforge.com/api/mcp

→ On first tool call, your browser opens; sign in once.

First MCP in Codex? Set experimental_use_rmcp_client = true in ~/.codex/config.toml.

Cursor

One-click install via Cursor deep link

Add to Cursor
Or paste this into .cursor/mcp.json
{
  "mcpServers": {
    "varynforge": {
      "url": "https://app.varynforge.com/api/mcp"
    }
  }
}

→ On first tool call, your browser opens; sign in once.

VS Code

One-click install via VS Code redirect

Add to VS Code
Or paste this into your MCP config
{
  "mcpServers": {
    "varynforge": {
      "url": "https://app.varynforge.com/api/mcp"
    }
  }
}

→ On first tool call, your browser opens; sign in once.

What your agent does

The whole SEO workflow.
Inside the host chat.

01

Connect once, OAuth-sign in

Drop the snippet into your host agent, restart, and follow the OAuth prompt. Better Auth handles the token exchange — no API keys to manage.

02

Hand your agent a project

"Set up a project for example.com." Niche analysis and asset mapping run asynchronously; your agent polls and reports back.

03

Forge briefs from ideas — or from research

Free tier: hand your agent topic ideas, forge writer-ready briefs (10 / day). Paid tier: run keyword research, harvest opportunity clusters into a content plan, forge briefs from data.

04

Use the brief as the writing prompt

Call download_brief_markdown and the host agent loads the brief plus the VarynForge writer system prompt — then drafts. No leaving the chat.

Tool catalog

57 tools, 13 categories.

Every tool returns structured JSON. Reads come back in agent-sized payloads (no 189K-token dumps); writes return entitlement context so your host agent always knows what to do next.

Projects + niche

  • create_project

    Create a new project from a website URL or niche description. Returns immediately; niche analysis and asset mapping run asynchronously.

  • list_projects

    List all projects for the authenticated operator.

  • list_organizations

    List the organizations this account belongs to — role, plan, member count — plus pending invitations. Plans and credits are per-organization.

  • get_project

    Get one project's niche profile, target audience, and research status.

  • get_project_asset

    Get the asset (website / product) associated with a project.

  • get_project_overview

    At-a-glance read on a project — niche summary, keyword stats, top-priority suggestions.

  • update_niche

    Update a niche profile (name, industry, language, country).

  • update_asset_profile

    Correct the inferred asset profile — description, primary offer, benefits, differentiators, use cases. No re-crawl.

  • resync_asset_profile

    Re-read the project website and re-infer the asset profile from its current content. Rate-limited per site.

  • remap_asset

    Re-crawl the project website and refresh its owned pages. Use when mapping errored or pages look stale.

  • set_posting_cadence

    Set how many articles per week the operator publishes (1-14). Sizes the pitch report's 90-day sequence.

Destinations

  • list_destinations

    List where the operator publishes — website, YouTube, TikTok, Instagram, X, LinkedIn, local business — with per-destination lint and publish capabilities.

  • add_destination

    Add a detected or planned destination to a project. Shapes where briefs, drafts, and lint formats anchor; up to 10 per project.

Research lifecycle

  • start_research_run

    Trigger a research run (paid; one credit).

  • get_research_status

    Poll the latest run — runId, status, progress percent, elapsed seconds, last error.

Keywords + opportunities

  • list_keywords

    List keywords tracked for a project — text, difficulty, intent, volume bucket.

  • get_keyword_detail

    Get a keyword's ranking pages and related project keywords.

  • list_opportunities

    List ranked content opportunity clusters. Goal filters: fast_wins, high_intent, authority_building, competitor_gap.

  • get_opportunity_detail

    Get a cluster's top-20 keywords, top-10 pages, top-5 podium, linked suggestions.

  • set_opportunity_status

    Dismiss or restore an opportunity cluster. Dismissed clusters leave list_opportunities and the content-plan harvest until the next research run.

  • set_excluded_terms

    Set project-level exclusion terms — products or topics the operator does not sell. Down-weights matching keywords and drops them from the harvest; survives re-runs.

Competitors

  • list_competitors

    List companies tracked as competitors for a project.

  • get_competitor_detail

    Company detail in a project context — top pages, top keywords.

  • set_competitor_importance

    Mark a competitor important / default / ignored.

  • add_competitor_by_domain

    Add a competitor by domain (e.g. example.com).

Pages

  • list_pages

    List ranked pages tracked for a project.

  • get_page_dossier

    Page dossier — title, URL, target keywords, content analysis, rankings.

Market radar

  • list_radar_topics

    Latest emergent-topic radar snapshot — rising narratives with momentum, novelty, drivers, evidence, and how many suggestions each already spawned.

  • expand_radar_topic

    Expand one radar topic into 3-6 candidate article angles with title, intent, and positioning. Near-duplicates in the plan are flagged. No writes.

  • add_radar_topic

    Add chosen angles from a radar topic to the content plan as radar-born suggestions; each brief forges automatically.

Ideas

  • expand_idea

    Score a raw article idea against the niche — title, angle, intent, related queries, demand estimate, 0-100 niche fit. Writes nothing.

  • accept_idea

    Commit an expanded idea to the content plan as a brief-ready suggestion and forge its brief automatically.

  • check_idea

    Attach real search data to an existing suggestion — one live Google search per target keyword, volume bands, ranking pages. No credits; daily-capped.

Content plan + suggestions

  • list_article_suggestions

    List article suggestions in a project's content plan.

  • get_article_suggestion

    Get an article suggestion's details and brief availability.

  • add_article_suggestion

    Add a bare article suggestion (title + optional intent).

  • create_article_suggestion_with_input

    Free-tier path: create a brief-ready suggestion from the operator's own input (title, keywords, intent, audience, angle).

  • delete_article_suggestion

    Delete an article suggestion and its brief.

  • update_article_status

    Move an article through planned → generating_brief → brief_ready → out_for_writing → monitoring.

  • create_content_plan_from_opportunities

    Harvest top-30 opportunity clusters from a completed research run into a content plan.

Brief generation + writer handoff

  • generate_article_brief

    Forge a writer-ready brief. Idempotent: returns the existing brief without consuming quota; pass force: true to regenerate. Free: 10 / day. Paid: unlimited.

  • get_article_brief

    Get the full brief. Pass compact=true to drop referenceArticles (informational only); editorial fields stay populated.

  • download_brief_markdown

    Get the brief assembled as inline markdown (≤8K chars) for the host agent to use as a writing prompt.

  • get_write_handoff

    One-call writer handoff — compact payload with brief essentials, keywords, acceptance criteria, and lint instructions.

Draft verification + publishing

  • get_lint_rubric

    Verification rubric for a suggestion — submission format per channel, required vs advisory checks, exact numeric limits. Fetch before writing.

  • lint_draft

    Submit a draft (article, X thread, LinkedIn post, reels or YouTube script) for verification against its brief. Pass moves it to ready_to_publish; flag returns per-check detail.

  • get_draft_status

    Re-read a suggestion's stored drafts and latest lint receipts per destination without re-linting. Free and uncapped.

  • mark_article_published

    Record that an article went live at a URL — flips to published, writes the distribution ledger, pings IndexNow.

  • register_derived_asset

    Register a derivative (carousel PDF, social post, video, image) produced from an article for per-channel distribution and content-ROI reporting.

Reports

  • get_starting_point_report

    Free client-facing starting-point report from setup data — positioning, content inventory, competitor set, early rising-topic signals. No research run required.

  • get_pitch_report_payload

    Client-ready pitch report for a completed run — niche profile, competitor landscape, gap-only opportunity map, and a cadence-sized 90-day content sequence.

Agent guidance

  • get_instructions

    VarynForge workflow guide for the host agent (free vs paid paths, token-economy rules, walls).

  • get_onboarding_guide

    Diagnose where the operator is in their VarynForge journey — stage, setup checklist, ranked next actions. Call when list_projects is empty.

  • get_account_status

    Current plan, limits, locked tools, upgrade URL, plans summary.

  • get_writer_system_prompt

    Writer system prompt the host agent loads before drafting articles.

  • send_feedback

    File a bug, missing capability, friction point, or idea to the VarynForge team. Not for entitlement walls.

  • get_changelog

    URL of the product changelog — what shipped, newest first, in plain markdown.

Free vs paid

Free until research runs.

The paywall sits at the research run — every other tool is free. Brief generation is idempotent and does not burn quota on re-reads.

Free

Forge briefs from your own ideas

  • →Create projects, run niche analysis, map your sitemap
  • →Forge briefs from operator-supplied input (title, keywords, intent)
  • →10 briefs / day
  • →Browse research-discovered opportunities once a paid run lands
Start free
Paid

Forge briefs from research-grade data

  • →Trigger research runs — one credit each
  • →Get ranked opportunity clusters, competitor pages, keyword intent
  • →Unlimited briefs from research-derived suggestions
  • →Plans start at $75 / mo
See pricing
FAQ

MCP, answered.

Forge from your host

Connect once. Forge from the chat.

Start a free project See pricing