Operator docs · not a product UI

Agents & MCP

For humans and agents who operate Northern Forge — ship, maintain, market, unlock. End-user tools stay clean; this page is the runbook.

Audience: agent builders & operators. Product pages never paste thrift budgets, deploy quotas, or module paths into free-tool chrome.

Always-on continuumMesh, thrift, revenue, fleet oil, cosmos, product ship, evening remeasure.

Grok skillsSlash-loadable ops: stack, QoL, thrift/cash, AI magic, identity, UX shell.

MCP surfaceDeploy, money, work, design, analytics, docs — typed tools agents call.

Conversion APICheckout, unlocks, events, popular, AI, identity — rate-limited & hardened.

Ship gateScaffold detection demotes hollow stubs before they stay “live.”

ExposureThrift paste packs + niche long-form articles — specific problems only.

Closed loop

01 DreamIdea / radar / next product from demand and catalog gaps.

02 DesignHTML + UX shell, identity, magic buttons, public-voice QoL.

03 ShipVercel deploy (CLI or MCP); Hobby quota-aware.

04 MarketPaste packs; optional X API; niche articles.

05 OilFleet maintain: audit, unlocks, AI smoke, hub sync, glass.

06 CashContextual pro → Stripe Checkout → verify → unlock keys.

Public voice: product UIs speak to end users only. Ops language stays here, in AGENTS.md, and agent surfaces.

Always-on ticks

always_on runs overlapping cadences. Product tick has a hard timeout so hangs can’t freeze the supervisor.

15m mesh 45m thrift + articles 90m product ship 2h revenue 3h fleet oil 4h cosmos ~20h evening

Tick	Module	What agents do
mesh	`always_on`	Shared context, command center, memory hygiene.
thrift	`thrift_market.py` · `x_articles.py`	Paste-ready posts; niche long-form when budget allows.
product	`autonomous_digital_product_agent.py`	Design → QoL → deploy → promote (isolated + timeout).
revenue	`revenue_tracker.py`	Unlocks, payment paths, ledger health.
maintain	`fleet_maintain.py`	Oil: QoL, design scores, unlocks, AI smoke, hub sync.
cosmos	`cosmos_loop.py`	Loop score, popular/events durability, thrift pulse.
evening	remeasure	Design audit + metrics when the day cools.

Stack map

Layer	Path	Role
Always-on	`always_on.py`	24/7 supervisor.
Fleet oil	`fleet_maintain.py`	QoL, audits, unlocks, AI health, hub sync.
QoL	`diamond_qol.py`	Public chrome, glass, contextual unlocks.
Design score	`design_audit.py`	Live design score + diversity.
Ship	`autonomous_digital_product_agent.py`	End-to-end product cycle.
Scaffold gate	`scaffold_guard.py`	Demote hollow stubs.
Market	`thrift_market.py`	Packs → `data/marketing_outbox`, `data/promote_now`.
Articles	`x_articles.py`	Long-form → `data/articles`.
Cosmos	`cosmos_loop.py`	Durable popular/events + scores.
Deploy budget	`deploy_quota.py`	Hobby 100 deploys/day awareness.
Conversion	`artifacts/nf-conversion`	Stripe, identity, AI, popular.
UX / identity	`ux_apply.py` · hub `js/nf-*`	NFUI, sign-in, magic, analytics.
Model router	`model_router.py`	Kimi Code, xAI, NVIDIA, …

Grok skills

/northern-forge-ops

Full stack: always_on, oil, thrift, Stripe, AI, watchdog.

/nf-qol-fleet

QoL, public voice, glass, deploy.

/nf-thrift-cash

Thrift packs, revenue, unlocks, ledger.

/nf-ai-magic

✨ generate, forge_prompts, multi-provider AI.

/nf-identity

Sessions, scores, trackers, NFID.

/nf-ux-shell

Modals, help, coach, brand assets.

/agentcard

Prepaid virtual cards for agent purchases.

/nf-fleet-oil

Fleet maintain oil cycle.

Commands

python3 scripts/healthcheck.py
python3 fleet_maintain.py oil
python3 thrift_market.py tick
python3 x_articles.py generate
python3 cosmos_loop.py status
python3 infra_tier.py status
python3 design_audit.py
bash scripts/watchdog.sh

cd artifacts/northern-forge-hub && vercel deploy --prod --yes
cd artifacts/nf-conversion && vercel deploy --prod --yes

Manifest: config/system_manifest.json · Continuum: AGENTS.md

First-party MCP (we ship these)

Northern Forge builds our own MCP servers as products — not only connecting to Vercel/Stripe MCP. Free core tools agents can call today.

Northern Forge MCP Catalog, popular, golden hour, pack weight, prompts, events, payment links. flagship nf-mcp.vercel.app /mcp · /tools

curl -s https://nf-mcp.vercel.app/tools \
  -H 'content-type: application/json' \
  -d '{"name":"list_live_products","arguments":{"limit":5}}'

Ship path: product cycles now invent mcp_server and agent_skill kinds (~45% / 15%), not only static HTML. Env: NF_PRODUCT_KIND=mcp or NF_PRODUCT_KIND_WEIGHTS.

Observe the loop

Efficient operator view — one screen, no thrift noise.

cd /root/autonomous-digital-products
python3 scripts/loop_status.py          # dense status
python3 scripts/loop_status.py --watch  # refresh 30s
bash scripts/loop_watch.sh -f           # status + log follow
tail -f data/logs/always_on.log
# open local: data/command_center/index.html

MCP servers

Typed tools agents call. Prefer MCP when authenticated; fall back to CLI/API when tokens are stale.

VercelDeploy, env, projects, domains, logs.infra

StripeCheckout, payments, unlock fulfillment.money

GitHubCatalog, issues, files. OAuth vs PAT scope.source

LinearIssues, projects, ship status.work

MixpanelProduct analytics events.analytics

FigmaDesign systems.design

CanvaMarketing creatives.design

ExcalidrawArchitecture diagrams.design

X docsOfficial X platform docs.docs

GmailOps mail channel.comms

Google DriveShared files for campaigns.files

Google CalendarLaunch scheduling.time

NotionSpecs and notes.docs

GammaDecks for pitches.design

TasksAgent TODOs.work

HyperframesVideo/frame generation.media

Auth tip: Vercel MCP needs live OAuth; if REST 403, use CLI session. GitHub writes prefer MCP OAuth when PAT is contents-read only.

Conversion API

Base: https://nf-conversion.vercel.app · rate limits · CORS · catalog-driven checkout.

Endpoint	Use
`POST /api/checkout`	Stripe Checkout for a product_id (contextual).
`GET /api/checkout`	List pro catalog.
`GET /api/unlock/verify`	Paid session → unlock key.
`POST /api/event`	Analytics beacons.
`GET /api/analytics/popular`	Hot / popular ranking.
`POST /api/ai/generate`	AI magic (Kimi/Moonshot, NVIDIA, xAI…).
`POST/GET /api/auth/session`	Identity + HMAC tokens.
`/api/scores` · `/api/trackers`	Leaderboards & progress blobs.
`POST /api/stripe/webhook`	Fulfillment on paid checkout.

Marketing resources (on disk)

Path	What
`data/promote_now/LATEST.md`	Newest thrift pack to paste.
`data/marketing_outbox/`	All READY_TO_POST / THRIFT_PROMOTE packs.
`data/sales/SHARE_NOW.md`	Sales blast tweets + buy links.
`data/articles/`	Niche long-form drafts.
`data/social/`	Playbook, pinned post, promo log.

Hub tools agents use

Prompt ForgeClaude + GPT + Grok from one note set. Open

Copy ForgeLaunch posts for any product. Open

CatalogLive inventory. GitHub

RevenueContextual pro unlocks. Open

Three surfaces: (1) public tools people click, (2) ops agents that ship them, (3) MCP + HTTP APIs those agents call. Wire skills + conversion + thrift outbox before inventing another dashboard.

Back to hub GitHub catalog Conversion API @NForge26