Which hosts work with the VarynForge MCP server?

Any MCP-compatible host — Claude Desktop, Cursor, Claude Code, plus custom harnesses that speak Model Context Protocol. The server runs at https://app.varynforge.com/api/mcp with streamable HTTP transport.

Do I need an API key?

No. Connection is OAuth-secured (Better Auth). On first tool use, your host opens a browser tab where you sign in — the same way you would sign into the web app. Your agent then carries that session.

What does the free tier actually let me do?

You can create projects, run niche analysis, and forge up to 10 writer-ready briefs per day from your own input — title, target keywords, intent, audience, angle. That covers a host agent driving the full draft pipeline without ever hitting a paywall, as long as you supply the article ideas.

When does a tool burn a credit?

Only start_research_run consumes a research credit. Niche analysis, asset mapping, sitemap mapping, brief generation from operator input, and every read-side tool are free. generate_article_brief is idempotent — calling it twice on the same suggestion returns the existing brief without burning quota.

How do walls surface to the host agent?

Paywalled tools and rate limits return a structured payload — { error_code, reason, remaining, reset_at, upgrade_url, upgrade_rationale, what_unlocks, alternative_free_actions } — instead of a generic JSON-RPC error. Your agent reads those fields and tells you exactly what to do next.

Can I see what the host agent is doing?

Yes. Open the web app at app.varynforge.com to see every project the MCP creates, every research run it triggers, every brief it forges. The MCP and the web app share one source of truth.

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

31+ 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

1Open Claude Desktop → Settings → Connectors
2Click Add custom connector
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.

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.

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.

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.

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

31+ tools, eight 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.
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).

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.

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).

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.

Agent guidance

get_instructions
VarynForge workflow guide for the host agent (free vs paid paths, token-economy rules, walls).
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.

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

Read your site.Forge your next ten articles.

Pick your host. Connect once.

Claude Desktop

Claude Code

Codex

Cursor

VS Code

The whole SEO workflow.Inside the host chat.

Connect once, OAuth-sign in

Hand your agent a project

Forge briefs from ideas — or from research

Use the brief as the writing prompt

31+ tools, eight categories.

Projects + niche

Research lifecycle

Keywords + opportunities

Competitors

Pages

Content plan + suggestions

Brief generation + writer handoff

Agent guidance

Free until research runs.

Forge briefs from your own ideas

Forge briefs from research-grade data

MCP, answered.

Which hosts work with the VarynForge MCP server?

Do I need an API key?

What does the free tier actually let me do?

When does a tool burn a credit?

How do walls surface to the host agent?

Can I see what the host agent is doing?

Connect once. Forge from the chat.

Read your site.
Forge your next ten articles.

The whole SEO workflow.
Inside the host chat.