mcpField
T
Tengence GEO Agent

Tengence GEO Agent

Local
github.com/tengence-teamBusiness & Marketing0Updated 1d ago
Repository

About Tengence GEO Agent

Tengence GEO Agent is a GEO/SEO content production and publishing project for teams managing multiple sites. It offers CLI, MCP, and built-in agent modes, linking planning and writing with checks, WordPress publishing, search submission, and visibility monitoring.

Key features

  1. 01Plan, write, and ingest articles
  2. 02Run content gate checks
  3. 03Publish to WordPress
  4. 04Submit to search and monitor GEO visibility
  5. 05CLI, MCP, and agent runtime modes
  6. 06SQLite storage with optional MySQL

Use cases

  1. 01Managing content production across multiple sites
  2. 02Checking articles against GEO standards
  3. 03Publishing articles and submitting them to search
  4. 04Monitoring content visibility in AI

MCP support

@tengence/geo-mcp provides 29 tools over stdio and Streamable HTTP; HTTP transport uses Bearer authentication. MCP resources also expose the GEO standards index and individual standards.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "tengence-team-geo": {
      "command": "npx",
      "args": [
        "-y",
        "@tengence/geo-mcp"
      ],
      "env": {
        "SITES_ROOT": "<SITES_ROOT>",
        "TENGENCE_GEO_HOME": "<TENGENCE_GEO_HOME>",
        "DB_DRIVER": "<DB_DRIVER>"
      }
    }
  }
}
Run commandnpx -y @tengence/geo-mcp
Environment variables to set
SITES_ROOTRoot directory holding per-site config and .env files. Optional; the workspace is chosen at runtime via the workspace_use tool.
TENGENCE_GEO_HOMEInternal runtime data directory (DB, caches). Defaults to ~/.tengence/geo-mcp.
DB_DRIVERStorage backend: sqlite (default) or mysql for production.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@tengence/geo-mcp0.1.1

Tools

56

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
pathstringYesabsolute directory path chosen by the user (e.g. ~/my-geo-workspace)
createbooleanNocreate the directory when missing (default false)

Details

From the project README

Tengence GEO Agent

GEO/SEO content production & publishing engine — full-pipeline automation from content planning → writing & ingest → gate checks → WordPress publishing → search submission → GEO monitoring. Three usage modes: CLI / MCP (AI clients) / built-in agent runtime loop. Default storage is a single-file multi-tenant SQLite (auto-initialized) with optional MySQL; designed for open source and multi-site use.

  AI clients (any MCP-capable harness)
        │  MCP (stdio or Streamable HTTP + Bearer)
        ▼
  @tengence/geo-mcp     29 tools (workspace/site/article/check/publish/plan/image/monitor/db/search/diagnose/util/standards)
        ▼
  @tengence/geo-cli     21 tengence-geo-* commands
        ▼
  @tengence/geo-sdk     15-domain capability layer (site/db/wp/content/images/search/…)
        ▼
  SQLite (auto-init)  or  MySQL (tengence_geo_*, isolated from prod tengence_omni_*)

Packages (monorepo)

PackageFormDescription
@tengence/geo-sdkLibrary15-domain capability layer, lazy-loaded, single require entry
@tengence/geo-cliCLI21 bins (ingest / gate / publish / images / submission / monitor / plan)
@tengence/geo-mcpMCP Server29 tools, stdio + HTTP dual transport, Bearer auth
@tengence/geo-agentAgent launcherRuns once DEEPSEEK_API_KEY is set (HARNESS=dsh|opencode|pi)

Quick start

npm install
cp -R examples/site-template ~/tengence/sites/my-site
cd ~/tengence/sites/my-site && cp .env.example .env   # fill in WP credentials / tokens

# Full CLI pipeline
export SITES_ROOT=~/tengence/sites
tengence-geo-article-ingest hello-geo ./hello-geo.md --site my-site --research ./hello-geo.research.md
tengence-geo-check-article hello-geo --site my-site

# MCP (any MCP-capable client; see docs/mcp-platforms.md)
node packages/geo-mcp/bin/geo-mcp.js                          # stdio
GEO_MCP_TOKEN=sk-xxx node packages/geo-mcp/bin/geo-mcp-http.js  # HTTP

# Agent (runs once the API key is set)
export DEEPSEEK_API_KEY=sk-xxx
npx -y @tengence/geo-agent

Full onboarding: docs/getting-started.md.

Documentation

Development & verification

npm run build          # workspace consistency check
npm test               # 138 tests (all green on SQLite)
npm run geo:sdk-smoke  # SDK smoke test

Security boundaries

  • Secrets live only in SITES_ROOT/<site>/.env (gitignored); the repo ships only the .env.example template.
  • The production MySQL (tengence_omni_*) is never written by this repo; the new repo uniformly uses tengence_geo_*.
  • The MCP HTTP transport requires GEO_MCP_TOKEN (Bearer).

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.