@silverbackbase/root

Business knowledge primitive for AI agents. Gives agents a durable, structured understanding of a business — offers, personas, objections, differentiators, competitors, geo zones, pricing, FAQs.

How it works

Give Root a client URL. In 5 minutes, all your agents have full business context — no manual briefing.

URL → Firecrawl (site scraping) → LLM extraction → DataForSEO (local competitors) → structured knowledge

MCP Tools

Tool	Type	Description
root_get_context	Read	Full business knowledge — call before any content/SEO/prospection task
root_get_category	Read	Specific category (personas, objections, etc.)
root_search	Read	Text search across all knowledge
root_onboard_from_url	Write	Onboard a client from their website URL
root_refresh	Write	Re-query SERP and detect new/lost competitors — run weekly or on demand
root_create_item	Write	Add a knowledge item manually
root_update_item	Write	Update an existing item
root_delete_item	Write	Delete an item

---

Self-hosted

Requirements

• Node.js ≥ 22
• Firecrawl API key (for onboarding)
• Anthropic API key (for LLM extraction)
• DataForSEO credentials (for competitor analysis, optional)

No database setup required — Root uses SQLite by default.

Install

Add to your Claude Code MCP config (.mcp.json in your project, or ~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "root": {
      "command": "npx",
      "args": ["-y", "--package=@silverbackbase/root", "root-mcp"],
      "env": {
        "ROOT_ACCOUNT_ID": "my-agency",
        "ANTHROPIC_API_KEY": "sk-ant-...",
        "FIRECRAWL_API_KEY": "fc-...",
        "DATAFORSEO_LOGIN": "...",
        "DATAFORSEO_PASSWORD": "..."
      }
    }
  }
}

Root creates a root.db SQLite file automatically on first run. No migration, no setup.

---

Cloud deployment

For multi-user or hosted setups, set DATABASE_URL to switch to PostgreSQL automatically:

DATABASE_URL=postgresql://user:password@host:5432/root
ROOT_ACCOUNT_ID=my-agency
ANTHROPIC_API_KEY=sk-ant-...
FIRECRAWL_API_KEY=fc-...

Root detects DATABASE_URL at startup and creates the table if it doesn't exist.

---

Environment variables

Variable	Required	Description
ROOT_ACCOUNT_ID	No	Account identifier (default: "default")
DB_PATH	No	SQLite file path (default: ./root.db). Ignored when DATABASE_URL is set.
DATABASE_URL	No	PostgreSQL connection string. If set, Root uses Postgres instead of SQLite.
ANTHROPIC_API_KEY	For onboarding	LLM extraction from website content
FIRECRAWL_API_KEY	For onboarding	Website scraping
DATAFORSEO_LOGIN	For onboarding + refresh	Competitor analysis via SERP
DATAFORSEO_PASSWORD	For onboarding + refresh	Competitor analysis via SERP
ROOT_REFRESH_CRON	No	Cron expression for automatic market refresh (e.g. 0 8 * * 1 = every Monday 8am). Scheduler is disabled if not set.

---

Knowledge categories

Category	Contains
offer	Services, products, prices
persona	Target customer profiles
objection	Common sales objections and responses
differentiator	Competitive advantages
competitor	Competitor names, positioning, weaknesses
geo	Geographic zones served
pricing	Pricing structure and packages
faq	Frequently asked questions
profile	General business profile (name, sector, tone)

---

Requirements

• Node.js 22+
• Claude Code or any MCP-compatible AI agent

License

MIT — SilverBackBase