Tengence GEO Agent
GEO/SEO content engine: planning, writing, gate checks, WordPress publishing, GEO monitoring.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
tengence-geo-agentclaude mcp add tengence-geo-agent -- npx -y tengence-geo-agent@0.1.3 '<CLI command that starts the MCP server (stdio)>'
{
"mcpServers": {
"tengence-geo-agent": {
"command": "npx",
"args": [
"-y",
"tengence-geo-agent@0.1.3",
"<CLI command that starts the MCP server (stdio)>"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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)
| Package | Form | Description | ||
|---|---|---|---|---|
@tengence/geo-sdk | Library | 15-domain capability layer, lazy-loaded, single require entry | ||
@tengence/geo-cli | CLI | 21 bins (ingest / gate / publish / images / submission / monitor / plan) | ||
@tengence/geo-mcp | MCP Server | 29 tools, stdio + HTTP dual transport, Bearer auth | ||
@tengence/geo-agent | Agent launcher | Runs 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
- Architecture & design decisions (layering / multi-tenancy / init model / why MCP bridging)
- Generic writing & GEO standards — shipped in
@tengence/geo-sdk, consumed via the MCP resourcesgeo://standard-index/geo://standard/{name}and thearticle_drafttool (the requirements an article must satisfy) - Getting started
- MCP integration (stdio / HTTP, any client)
- Release & distribution (npm / Docker)
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.exampletemplate. - The production MySQL (
tengence_omni_*) is never written by this repo; the new repo uniformly usestengence_geo_*. - The MCP HTTP transport requires
GEO_MCP_TOKEN(Bearer).
License
MIT
Frequently asked questions
What is Tengence GEO Agent?
GEO/SEO content engine: planning, writing, gate checks, WordPress publishing, GEO monitoring.
How do I install Tengence GEO Agent?
It runs on your machine. In Claude Code: claude mcp add tengence-geo-agent -- npx -y tengence-geo-agent@0.1.3 '<CLI command that starts the MCP server (stdio)>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Tengence GEO Agent need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Tengence GEO Agent open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Tengence GEO Agent?
It is published by tengence-team. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.