selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
NorthCinder logo

Self-host NorthCinder

v0.2.1

Local MCP shopping agent that asks before it buys

BetaOpen SourceMIT
Updated2 months ago
LanguageJavaScript
Setup difficultyModerate
Stars
1 205
Install with NPM

What is NorthCinder?

Should you self-host NorthCinder?

NorthCinder scores 33/100 on selfhost.directory (how scoring works) and ranks #196 of 209 in AI Agents. It has 1 205 GitHub stars.

It shipped 3 stable releases in the past year. The latest, v0.2.1, came out on 22 August 2026. New versions land roughly every 3 days.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is Orca (91/100, 108 815 stars). It scores higher overall, so compare the two before you pick. See NorthCinder vs Orca side by side.

Features

  • Browser observation handoff
  • Cardless checkout handoff
  • Client-side ranking verification
  • Deterministic ranking with reasons
  • Human-in-the-loop purchase approval
  • Local audit log
  • Local-first execution
  • MCP Server Integration
  • Merchant trust levels
  • Price watch alerts
  • Product and seller research plans
  • Product comparison search
  • Separate self-hosted engine
  • Sponsored offer labelling

NorthCinder README

How to install NorthCinder

Install NorthCinder with NPM

npx northcinder init

Creates buyer-local configuration and prints the MCP entry for your AI app; local mode runs the MCP server and search engine in one process.

How to configure NorthCinder

  • AMAZON_SESSION_PROFILEBuyer-owned Chrome profile directory for the read-only Amazon adapter; without it the adapter reports not_configured

    Buyer-owned Chrome profile directory for the read-only Amazon adapter; without it the adapter reports not_configured

  • EBAY_CLIENT_IDClient ID of the buyer's eBay application keyset

    Client ID of the buyer's eBay application keyset

  • EBAY_CLIENT_SECRETClient secret of the buyer's eBay application keyset

    Client secret of the buyer's eBay application keyset

  • EBAY_ENVWhich eBay environment the adapter targets

    Which eBay environment the adapter targets

    values: sandbox | production

  • ETSY_API_KEYApproved Etsy Open API v3 keystring; without it the adapter reports not_configured

    Approved Etsy Open API v3 keystring; without it the adapter reports not_configured

  • NORTHCINDER_API_KEYSKeys set on a separately deployed aggregation engine to protect it

    Keys set on a separately deployed aggregation engine to protect it

  • NORTHCINDER_CLIENT_KEYBuyer-generated key the client sends as a bearer credential to the engine

    Buyer-generated key the client sends as a bearer credential to the engine

  • NORTHCINDER_SERVICE_URLAddress of that self-hosted engine the client talks to; HTTPS required for non-loopback use

    Address of that self-hosted engine the client talks to; HTTPS required for non-loopback use

  • SHOPIFY_GLOBAL_CATALOG_API_KEYOptional compatibility bearer for the Shopify Global Catalog, sent only when configured

    Optional compatibility bearer for the Shopify Global Catalog, sent only when configured

  • SHOPIFY_GLOBAL_CATALOG_MCP_URLEndpoint URL of the Shopify Global Catalog UCP MCP interface

    Endpoint URL of the Shopify Global Catalog UCP MCP interface

  • SHOPIFY_MCP_SHOPSConfigured shop hosts used for Storefront Catalog search and fallback

    Configured shop hosts used for Storefront Catalog search and fallback

  • SHOPIFY_UCP_AGENT_PROFILE_URLPublicly fetchable HTTPS UCP agent-profile URL required on every Shopify catalog call

    Publicly fetchable HTTPS UCP agent-profile URL required on every Shopify catalog call

  • WOOCOMMERCE_STORE_HOSTSComma-separated bare WooCommerce hostnames to search; with none set the adapter reports not_configured

    Comma-separated bare WooCommerce hostnames to search; with none set the adapter reports not_configured

NorthCinder releases & version history

More in E-commerce

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…