Proximens Oracle
by cryptosun · remote · no sign-in to list tools · v1.0.0 · published by GitHub user cryptosun
1000+ Generative Engine Optimization (GEO) principles exposed via MCP for AI agents.
8 tools: 2 change things and 6 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things2Claude Code: ask: see these tools
- Only reads6Claude Code: allow: see these tools
1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http proximens-oracle https://www.proximens.nl/mcpFindings
Matches of fixed checks, with the text they matched.
The server marks "proximens_geo_synthesize_brief" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}; The description's first verb is "generate": a word for a change.
Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
8 tools
Changes things 2Claude Code: ask
proximens_geo_audit_urlPro-tier.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Pro-tier. Fetch and analyze a web page, then audit it against the Proximens GEO Engine principles across all major GEO dimensions (structured data, crawler access, content depth, freshness, E-E-A-T, multimodal). INPUT: url (required, http/https); optional mode ("fast" = quick signal checks, returns in seconds — the default; "deep" = a full AI-synthesized consultancy report in Dutch with a 7-dimension scorecard and sector benchmark, takes ~30-50s), client_name (report header), branche_hint ("main:sub", e.g. "health_wellness:yoga_studio"), max_issues (1-25, default 10). RETURNS: JSON with a 0-100 score, severity-ranked issues (critical/major/minor) each with a finding and an actionable suggestion, top recommendations, and a markdown report; deep mode additionally returns score_set (7 GEO dimensions), sector (benchmark cohort), and a full consultancy-grade report_markdown (deep_mode="timeout_fallback" means the synthesis exceeded its budget and the fast result was returned instead). USE fast mode for quick checks and bulk triage; USE deep mode when you need a client-ready audit report. Free tier is blocked.
Annotations the server declares
- title: Audit URL against Proximens GEO Engine
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
proximens_geo_synthesize_briefGenerate a structured, GEO-optimized content brief for a topic using the Proximens GEO Engine.1 finding
Why it is in this group
- The description's first verb is "generate": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
The server marks "proximens_geo_synthesize_brief" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}; The description's first verb is "generate": a word for a change.
Description, as the server wrote it Generate a structured, GEO-optimized content brief for a topic using the Proximens GEO Engine. INPUT: topic (3-200 chars); optional target_branche (one of 7 verticals), word_count_target (300-5000, default 1500) and up to 3 competitor_urls. RETURNS: JSON with a suggested H1 and H2 section structure with key points, the principles the content should address, and (Pro/Enterprise) FAQ suggestions and recommended schema.org markup. USE WHEN you need to brief a writer so a page is built to be cited by AI search engines.
Annotations the server declares
- title: Synthesize Content Brief from Proximens GEO Engine
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
Only reads 6Claude Code: allow
proximens_geo_bulk_searchPro-tier.No findings
Why it is in this group
- The name "proximens_geo_bulk_search" says "search": a word for reading.
Description, as the server wrote it Pro-tier. Run many GEO-principle searches in a single fast call. INPUT: queries (array of 2-100 natural-language strings, each 3-500 chars); optional top_k_per_query (1-10, default 5) and category filter. RETURNS: JSON with a results array (per query: the query, its matched principles, and a count), plus total_queries, total_matches and processing time. USE WHEN you need many lookups at once, e.g. a full-site audit or a keyword list, instead of repeated search_principles calls.
Annotations the server declares
- title: Bulk Search Proximens GEO Engine
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
proximens_geo_compare_urlsPro-tier.No findings
Why it is in this group
- The name "proximens_geo_compare_urls" says "compare": a word for reading.
Description, as the server wrote it Pro-tier. Fetch two web pages (your URL and a competitor's) and audit both against the Proximens GEO Engine principles using the same audit engine as audit_url, then compute the delta. INPUT: self_url and competitor_url (both required, http/https). RETURNS: JSON with a 0-100 score per URL (same scoring as audit_url), the principles each page satisfies, the principles each page VIOLATES that the other satisfies (delta_principles), and strategic insights on where to close the gap. USE WHEN you want a competitive GEO gap analysis between your page and a rival's.
Annotations the server declares
- title: Compare URLs against Proximens GEO Engine
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
proximens_geo_get_principleFetch one GEO principle from the Proximens GEO Engine by its UUID.No findings
Why it is in this group
- The name "proximens_geo_get_principle" says "get": a word for reading.
Description, as the server wrote it Fetch one GEO principle from the Proximens GEO Engine by its UUID. INPUT: id (UUID, normally taken from a prior search_principles result). RETURNS: a single principle as JSON with id, title, summary, category and confidence; Pro/Enterprise tiers additionally return full_text, source_url, source_type, evidence_count and the last-validated timestamp. USE WHEN you already have a principle id and need its full detail — typically to drill down after search_principles.
Annotations the server declares
- title: Get GEO principle by ID
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
proximens_geo_get_statsReturn live aggregate statistics for the Proximens GEO Engine knowledge base.No findings
Why it is in this group
- The name "proximens_geo_get_stats" says "get": a word for reading.
Description, as the server wrote it Return live aggregate statistics for the Proximens GEO Engine knowledge base. INPUT: none. RETURNS: JSON with total_principles (high-confidence count), total_categories, and on Pro/Enterprise also extended quality metrics (full corpus size and a confidence_distribution) plus the last-validated timestamp. USE WHEN you need to gauge the size and quality of the corpus before relying on it.
Annotations the server declares
- title: Get GEO Engine statistics
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
proximens_geo_list_categoriesList the GEO principle taxonomy of the Proximens GEO Engine with a live count of high-confidence principles per category.No findings
Why it is in this group
- The name "proximens_geo_list_categories" says "list": a word for reading.
Description, as the server wrote it List the GEO principle taxonomy of the Proximens GEO Engine with a live count of high-confidence principles per category. INPUT: none. RETURNS: JSON with a categories array of {category, count, description} sorted by count, plus a reconciled total that matches get_stats.total_principles. Categories: technical, structured-data, ai-search, content, e-e-a-t, freshness, multimodal, user-signals, performance, query-intent, internal-linking, mobile, other. USE WHEN you want to discover which categories exist before narrowing a search_principles call with the category filter.
Annotations the server declares
- title: List GEO principle categories
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
proximens_geo_search_principlesSemantic search over the Proximens GEO Engine: a curated, continuously-updated knowledge base of 4.000+ verified Generative Engine Optimization (GEO/AEO) principles, each graded by…No findings
Why it is in this group
- The name "proximens_geo_search_principles" says "search": a word for reading.
Description, as the server wrote it Semantic search over the Proximens GEO Engine: a curated, continuously-updated knowledge base of 4.000+ verified Generative Engine Optimization (GEO/AEO) principles, each graded by a 0-1 confidence score and traceable to a verified source. INPUT: query (natural language, 3-500 chars); optional category (one of 13 GEO categories), top_k (1-25, default 10), min_confidence (0-1, default 0.5). RETURNS: ranked principles as JSON, each with id, title, summary, category, confidence and a relevance score; Pro/Enterprise tiers additionally return full_text and source. USE WHEN you need evidence-backed answers about how AI search engines (ChatGPT, Perplexity, Gemini, Google AI Overviews, Copilot) select, rank and cite web content.
Annotations the server declares
- title: Search GEO principles (Proximens GEO Engine)
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.0.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http proximens-oracle https://www.proximens.nl/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__proximens-oracle__proximens_geo_search_principles",
"mcp__proximens-oracle__proximens_geo_get_principle",
"mcp__proximens-oracle__proximens_geo_list_categories",
"mcp__proximens-oracle__proximens_geo_get_stats",
"mcp__proximens-oracle__proximens_geo_compare_urls",
"mcp__proximens-oracle__proximens_geo_bulk_search"
],
"ask": [
"mcp__proximens-oracle__proximens_geo_audit_url",
"mcp__proximens-oracle__proximens_geo_synthesize_brief"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as proximens-oracle. Review it before you use it.
