Tengence GEO Agent — Claude Code MCP server: setup guide
Content pipeline MCP server that plans, audits, and publishes articles to WordPress while tracking AI search visibility. Built for multi-site workflows.
claude mcp add --env SITES_ROOT=<SITES_ROOT> --env TENGENCE_GEO_HOME=<TENGENCE_GEO_HOME> --env DB_DRIVER=<DB_DRIVER> --transport stdio tengence-geo-agent -- npx -y @tengence/geo-mcpWhat Tengence GEO Agent does
The @tengence/geo-mcp package exposes 29 tools covering article drafting, gate checks, image management, and WordPress publishing. Articles pass through automated checks before live deployment, ensuring compliance with structured editorial rules. Communication works over stdio or HTTP streaming.
Default persistence uses a single-file SQLite database that initializes automatically on first run. Teams needing external infrastructure can switch to MySQL tables under the dedicated tengence_geo_* prefix.
The HTTP transport will fail without a valid GEO_MCP_TOKEN bearer secret. Each managed site holds its credentials and WordPress access tokens in a local .env file under SITES_ROOT.
What it helps with
- run automated gate checks on markdown drafts before publication
- deploy reviewed content and media directly to WordPress
- submit newly published URLs to search engines
- track content visibility across generative search engines
Example prompts for the agent
- Run gate checks on
hello-geo.mdfor target sitemy-site - Push the approved article draft directly to the connected WordPress site
- Check search submission and index status for
my-site
How to install Tengence GEO Agent
Platform CLI
claude mcp add --env SITES_ROOT=<SITES_ROOT> --env TENGENCE_GEO_HOME=<TENGENCE_GEO_HOME> --env DB_DRIVER=<DB_DRIVER> --transport stdio tengence-geo-agent -- npx -y @tengence/geo-mcpReplace <…> with your own values
Platform CLI
codex mcp add tengence-geo-agent --env SITES_ROOT=<SITES_ROOT> --env TENGENCE_GEO_HOME=<TENGENCE_GEO_HOME> --env DB_DRIVER=<DB_DRIVER> -- npx -y @tengence/geo-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"tengence-geo-agent": {
"command": "npx",
"args": [
"-y",
"@tengence/geo-mcp"
],
"env": {
"SITES_ROOT": "<SITES_ROOT>",
"TENGENCE_GEO_HOME": "<TENGENCE_GEO_HOME>",
"DB_DRIVER": "<DB_DRIVER>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"tengence-geo-agent": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tengence/geo-mcp"
],
"env": {
"SITES_ROOT": "<SITES_ROOT>",
"TENGENCE_GEO_HOME": "<TENGENCE_GEO_HOME>",
"DB_DRIVER": "<DB_DRIVER>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e SITES_ROOT=<SITES_ROOT> -e TENGENCE_GEO_HOME=<TENGENCE_GEO_HOME> -e DB_DRIVER=<DB_DRIVER> tengence-geo-agent npx -y @tengence/geo-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Tengence GEO Agent
How to install Tengence GEO Agent in Claude Code?
Run claude mcp add geo -- npx -y @tengence/geo-mcp. To pass required variables, use `claude mcp add --env SITES_ROOT=<SITES_ROOT> --env TENGENCE_GEO_HOME=<TENGENCE_GEO_HOME> --env DB_DRIVER=<DB_DRIVER> --transport stdio tengence-geo-agent -- npx -y @tengence/geo-mcp`.
What does Tengence GEO Agent do?
It bridges AI assistants with an editorial pipeline that validates drafts, posts approved content to WordPress, submits URLs to search crawlers, and monitors AI visibility.
Which database engines are supported?
It uses an auto-initialized local SQLite database by default. You can also configure it to connect to MySQL tables partitioned under the tengence_geo_* prefix.
