Proximens Oracle is an MCP server published by io.github.cryptosun, hosted at www.proximens.nl. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 8 tools, including proximens_geo_search_principles, proximens_geo_get_principle, proximens_geo_list_categories, proximens_geo_get_stats, proximens_geo_audit_url.
1000+ Generative Engine Optimization (GEO) principles exposed via MCP for AI agents.
533 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Semantic search over the Proximens GEO Engine: a curated, continuously-updated knowledge base of Generative Engine Optimization (GEO/AEO) principles built from our own measurements and research, each graded by a 0-1 confidence score. INPUT: query (REQUIRED, natural language, 3-500 chars, e.g. "how does ChatGPT choose which FAQ to cite"); 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. 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.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Natural-language search query (e.g. "schema markup for local businesses" or "how to optimize for ChatGPT citations") |
| top_k | integer | Number of principles to return (max 25) |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| category |
| string |
| Filter by category (one of 13 GEO categories) |
| min_confidence | number | Minimum confidence score (0-1). Default 0.5 filters noise; raise to 0.8+ for high-confidence claims only |
{
"name": "proximens_geo_search_principles",
"title": "Search GEO principles (Proximens GEO Engine)",
"description": "Semantic search over the Proximens GEO Engine: a curated, continuously-updated knowledge base of Generative Engine Optimization (GEO/AEO) principles built from our own measurements and research, each graded by a 0-1 confidence score. INPUT: query (REQUIRED, natural language, 3-500 chars, e.g. \"how does ChatGPT choose which FAQ to cite\"); 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. 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.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Natural-language search query (e.g. \"schema markup for local businesses\" or \"how to optimize for ChatGPT citations\")"
},
"top_k": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Number of principles to return (max 25)"
},
"category": {
"enum": [
"technical",
"structured-data",
"content",
"ai-search",
"freshness",
"multimodal",
"user-signals",
"e-e-a-t",
"mobile",
"performance",
"query-intent",
"internal-linking",
"other"
],
"type": "string",
"description": "Filter by category (one of 13 GEO categories)"
},
"min_confidence": {
"type": "number",
"default": 0.5,
"maximum": 1,
"minimum": 0,
"description": "Minimum confidence score (0-1). Default 0.5 filters noise; raise to 0.8+ for high-confidence claims only"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"results",
"query_used"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"summary",
"category",
"confidence"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"_wm": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"category": {
"type": "string"
},
"full_text": {
"type": "string"
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"similarity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Relevance score for the query (0-1)"
},
"upgrade_hint": {
"type": "string"
},
"evidence_count": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
},
"tier_note": {
"type": "string",
"description": "Free-tier hint when top_k was capped"
},
"query_used": {
"type": "string"
},
"total_in_database": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search GEO principles (Proximens GEO Engine)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Fetch one GEO principle from the Proximens GEO Engine by its UUID. INPUT: id (REQUIRED, UUID string taken from a prior search_principles result — call search_principles first if you do not have one). RETURNS: a single principle as JSON with id, title, summary, category and confidence; Pro/Enterprise tiers additionally return full_text, 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.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Principle UUID (from search_principles results) |
{
"name": "proximens_geo_get_principle",
"title": "Get GEO principle by ID",
"description": "Fetch one GEO principle from the Proximens GEO Engine by its UUID. INPUT: id (REQUIRED, UUID string taken from a prior search_principles result — call search_principles first if you do not have one). RETURNS: a single principle as JSON with id, title, summary, category and confidence; Pro/Enterprise tiers additionally return full_text, 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.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Principle UUID (from search_principles results)"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"id",
"title",
"summary",
"category",
"confidence"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"_wm": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"branches": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"main",
"subs",
"relevance"
],
"properties": {
"main": {
"enum": [
"local_services",
"digital_services",
"product_commerce",
"creative_professional",
"health_wellness",
"b2b_saas",
"universal"
],
"type": "string"
},
"subs": {
"type": "array",
"items": {
"type": "string"
}
},
"relevance": {
"type": "integer",
"maximum": 3,
"minimum": 0
}
},
"additionalProperties": false
}
]
}
},
"category": {
"type": "string"
},
"full_text": {
"type": "string"
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"similarity": {
"type": [
"number",
"null"
]
},
"upgrade_hint": {
"type": "string"
},
"evidence_count": {
"type": "integer",
"minimum": 0
},
"source_diversity": {
"type": "integer",
"minimum": 0
},
"last_validated_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get GEO principle by ID",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the GEO principle taxonomy of the Proximens GEO Engine. INPUT: none. RETURNS: JSON with a categories array of {category, description}; Pro/Enterprise tiers additionally get a live count of high-confidence principles per category and 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.
No parameters.
{
"name": "proximens_geo_list_categories",
"title": "List GEO principle categories",
"description": "List the GEO principle taxonomy of the Proximens GEO Engine. INPUT: none. RETURNS: JSON with a categories array of {category, description}; Pro/Enterprise tiers additionally get a live count of high-confidence principles per category and 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.",
"inputSchema": {
"type": "object",
"properties": {},
"description": "No input parameters",
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"categories",
"cached"
],
"properties": {
"total": {
"type": "integer",
"minimum": 0
},
"cached": {
"type": "boolean"
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"category"
],
"properties": {
"count": {
"type": "integer",
"minimum": 0
},
"category": {
"type": "string"
},
"description": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "List GEO principle categories",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Return live aggregate statistics for the Proximens GEO Engine knowledge base. INPUT: none. RETURNS: JSON with total_categories and the last-distillation timestamp; Pro/Enterprise tiers additionally get total_principles (high-confidence count), the full corpus size, a confidence_distribution and the last-validated timestamp. USE WHEN you need to gauge the size and quality of the corpus before relying on it.
No parameters.
{
"name": "proximens_geo_get_stats",
"title": "Get GEO Engine statistics",
"description": "Return live aggregate statistics for the Proximens GEO Engine knowledge base. INPUT: none. RETURNS: JSON with total_categories and the last-distillation timestamp; Pro/Enterprise tiers additionally get total_principles (high-confidence count), the full corpus size, a confidence_distribution and the last-validated timestamp. USE WHEN you need to gauge the size and quality of the corpus before relying on it.",
"inputSchema": {
"type": "object",
"properties": {},
"description": "No input parameters",
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"total_categories"
],
"properties": {
"tier_hint": {
"type": "string"
},
"fetched_at": {
"type": "string"
},
"total_evaluated": {
"type": "integer",
"minimum": 0
},
"total_categories": {
"type": "integer",
"minimum": 0
},
"total_principles": {
"type": "integer",
"minimum": 0
},
"last_validated_at": {
"type": [
"string",
"null"
]
},
"last_distillation_at": {
"type": [
"string",
"null"
]
},
"confidence_distribution": {
"type": "object",
"required": [
">=0.9",
"0.8-0.9",
"0.7-0.8",
"<0.7"
],
"properties": {
"<0.7": {
"type": "integer",
"minimum": 0
},
">=0.9": {
"type": "integer",
"minimum": 0
},
"0.7-0.8": {
"type": "integer",
"minimum": 0
},
"0.8-0.9": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get GEO Engine statistics",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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" with gedeeltelijk=true means the synthesis did not fit the ~50 s budget and the fast, deterministic result was returned instead; deep_mode_reden says why). status="blocked" (login/SSO, HTTP 401/403, bot-challenge) or "unreadable" (no readable text) means NO report was generated — the reason is in error and blokkade. USE fast mode for quick checks and bulk triage; USE deep mode when you need a client-ready audit report. Free tier is blocked.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Target URL to audit |
| mode | string | fast = quick signal checks (seconds); deep = full AI-synthesized consultancy report with sector benchmark (~30-50s) |
| max_issues | integer | Maximum issues to return (default 10) |
| client_name | string | Optional client identifier for the audit report header |
| branche_hint | string | Branche hint in "main:sub" format, e.g. "health_wellness:yoga_studio". If omitted, principles are matched without branche filter. |
{
"name": "proximens_geo_audit_url",
"title": "Audit URL against Proximens GEO Engine",
"description": "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\" with gedeeltelijk=true means the synthesis did not fit the ~50 s budget and the fast, deterministic result was returned instead; deep_mode_reden says why). status=\"blocked\" (login/SSO, HTTP 401/403, bot-challenge) or \"unreadable\" (no readable text) means NO report was generated — the reason is in error and blokkade. USE fast mode for quick checks and bulk triage; USE deep mode when you need a client-ready audit report. Free tier is blocked.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "Target URL to audit"
},
"mode": {
"enum": [
"fast",
"deep"
],
"type": "string",
"default": "fast",
"description": "fast = quick signal checks (seconds); deep = full AI-synthesized consultancy report with sector benchmark (~30-50s)"
},
"max_issues": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Maximum issues to return (default 10)"
},
"client_name": {
"type": "string",
"description": "Optional client identifier for the audit report header"
},
"branche_hint": {
"type": "string",
"description": "Branche hint in \"main:sub\" format, e.g. \"health_wellness:yoga_studio\". If omitted, principles are matched without branche filter."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"audit_id",
"url",
"status"
],
"properties": {
"_wm": {
"type": "string"
},
"url": {
"type": "string"
},
"_meta": {
"type": "object",
"required": [
"tier",
"rate_limit_remaining",
"processed_at"
],
"properties": {
"tier": {
"enum": [
"free",
"pro",
"enterprise"
],
"type": "string"
},
"processed_at": {
"type": "string"
},
"rate_limit_remaining": {
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"const": "unlimited"
},
{
"type": "string",
"const": "unknown"
}
]
}
},
"additionalProperties": false
},
"error": {
"type": "string"
},
"score": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"sector": {
"type": "object",
"required": [
"slug",
"display_name_nl"
],
"properties": {
"slug": {
"type": "string"
},
"display_name_nl": {
"type": "string"
}
},
"description": "Detected sector benchmark cohort (deep mode only)",
"additionalProperties": false
},
"status": {
"enum": [
"complete",
"failed",
"blocked",
"unreadable"
],
"type": "string"
},
"signals": {
"type": "object",
"required": [
"structured_data_valid",
"structured_data_invalid",
"schema_types",
"schema_flags",
"h1_count",
"images_total",
"images_without_alt",
"has_canonical",
"hreflang_count",
"has_viewport",
"word_count",
"render_source"
],
"properties": {
"h1_count": {
"type": "integer",
"minimum": 0
},
"word_count": {
"type": "integer",
"minimum": 0
},
"has_viewport": {
"type": "boolean"
},
"images_total": {
"type": "integer",
"minimum": 0
},
"schema_flags": {
"type": "object",
"required": [
"organization",
"website",
"faqPage",
"product",
"breadcrumbList",
"localBusiness",
"article"
],
"properties": {
"article": {
"type": "boolean"
},
"faqPage": {
"type": "boolean"
},
"product": {
"type": "boolean"
},
"website": {
"type": "boolean"
},
"organization": {
"type": "boolean"
},
"localBusiness": {
"type": "boolean"
},
"breadcrumbList": {
"type": "boolean"
}
},
"additionalProperties": false
},
"schema_types": {
"type": "array",
"items": {
"type": "string"
}
},
"has_canonical": {
"type": "boolean"
},
"render_source": {
"enum": [
"firecrawl",
"fetch-fallback"
],
"type": "string"
},
"hreflang_count": {
"type": "integer",
"minimum": 0
},
"images_without_alt": {
"type": "integer",
"minimum": 0
},
"render_waarschuwing": {
"type": [
"string",
"null"
]
},
"structured_data_valid": {
"type": "integer",
"minimum": 0
},
"structured_data_invalid": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"audit_id": {
"type": "string",
"format": "uuid"
},
"blokkade": {
"type": "object",
"required": [
"status",
"signaal",
"reden",
"http_status"
],
"properties": {
"reden": {
"type": "string"
},
"status": {
"enum": [
"blocked",
"unreadable"
],
"type": "string"
},
"signaal": {
"type": "string"
},
"http_status": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
}
},
"description": "Waarom de pagina niet geaudit is (alleen bij status blocked/unreadable)",
"additionalProperties": false
},
"deep_mode": {
"enum": [
"ok",
"timeout_fallback"
],
"type": "string",
"description": "Deep-mode outcome: ok = full synthesized report; timeout_fallback = synthesis exceeded budget, fast result returned"
},
"score_set": {
"type": "object",
"required": [
"overallGEO",
"aiCitability",
"brandAuthority",
"contentEEAT",
"technicalGEO",
"structuredData",
"platformOptimization"
],
"properties": {
"overallGEO": {
"type": [
"number",
"null"
]
},
"contentEEAT": {
"type": [
"number",
"null"
]
},
"aiCitability": {
"type": [
"number",
"null"
]
},
"technicalGEO": {
"type": [
"number",
"null"
]
},
"brandAuthority": {
"type": [
"number",
"null"
]
},
"structuredData": {
"type": [
"number",
"null"
]
},
"platformOptimization": {
"type": [
"number",
"null"
]
}
},
"description": "7-dimension GEO scorecard (deep mode only)",
"additionalProperties": false
},
"error_code": {
"enum": [
"url_not_allowed",
"page_not_found",
"upstream_http_error",
"unsupported_content",
"upstream_unavailable",
"timeout",
"internal_error"
],
"type": "string",
"description": "Bij status failed: vaste foutcode (details staan alleen in de server-log)"
},
"bevindingen": {
"type": "array",
"items": {
"type": "object",
"required": [
"titel",
"bucket",
"bewijs_type"
],
"properties": {
"bron": {
"type": "string"
},
"titel": {
"type": "string"
},
"bucket": {
"enum": [
"crawlbaarheid",
"structuur",
"citatieVoetafdruk",
"meten"
],
"type": "string"
},
"severity": {
"type": "string"
},
"bewijs_type": {
"enum": [
"gemeten",
"afgeleid",
"advies"
],
"type": "string"
}
},
"additionalProperties": false
},
"description": "Deep mode: bevindingen uit het rapport, elk gelabeld gemeten | afgeleid | advies (gemeten alleen mét bron)"
},
"http_status": {
"type": "integer",
"description": "Bij status failed: HTTP-status van de doelpagina, als bekend"
},
"consistentie": {
"type": "object",
"required": [
"gecorrigeerd",
"claims"
],
"properties": {
"claims": {
"type": "array",
"items": {
"type": "object",
"required": [
"regel",
"tekst",
"reden"
],
"properties": {
"reden": {
"type": "string"
},
"regel": {
"type": "string"
},
"tekst": {
"type": "string"
}
},
"additionalProperties": false
}
},
"gecorrigeerd": {
"type": "integer",
"minimum": 0
}
},
"description": "Deep mode: passages die de gemeten feiten tegenspraken en zijn gecorrigeerd",
"additionalProperties": false
},
"gedeeltelijk": {
"type": "boolean",
"description": "true = deep mode gaf binnen het tijdbudget alleen het snelle resultaat (zie deep_mode_reden)"
},
"gemeten_feiten": {
"type": "object",
"description": "Deep mode: deterministisch gemeten feiten (JSON-LD, robots.txt, llms.txt, sitemap, datum) die de synthese als waarheid kreeg",
"additionalProperties": {}
},
"deep_mode_reden": {
"type": "string",
"description": "Waarom de AI-synthese niet is uitgevoerd (alleen bij timeout_fallback)"
},
"recommendations": {
"type": "array",
"items": {
"type": "string"
}
},
"report_markdown": {
"type": "string"
},
"matched_principles": {
"type": "array",
"items": {
"type": "object",
"required": [
"principle_id",
"principle_title",
"category",
"severity",
"finding",
"suggestion",
"confidence",
"bewijs_type"
],
"properties": {
"bron": {
"type": "string",
"description": "Meetbron, bv. \"JSON-LD op pagina\", \"robots.txt\""
},
"excerpt": {
"type": "string"
},
"finding": {
"type": "string"
},
"category": {
"type": "string"
},
"severity": {
"enum": [
"critical",
"major",
"minor"
],
"type": "string"
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"suggestion": {
"type": "string"
},
"bewijs_type": {
"enum": [
"gemeten",
"afgeleid",
"advies"
],
"type": "string"
},
"principle_id": {
"type": "string",
"format": "uuid"
},
"principle_title": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Audit URL against Proximens GEO Engine",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| self_url * | string | Your URL to audit |
| competitor_url * | string | Competitor URL to compare against |
{
"name": "proximens_geo_compare_urls",
"title": "Compare URLs against Proximens GEO Engine",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"self_url",
"competitor_url"
],
"properties": {
"self_url": {
"type": "string",
"format": "uri",
"description": "Your URL to audit"
},
"competitor_url": {
"type": "string",
"format": "uri",
"description": "Competitor URL to compare against"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"self_url",
"competitor_url",
"self_score",
"competitor_score",
"self_matched",
"competitor_matched",
"delta_principles",
"insights"
],
"properties": {
"_meta": {
"type": "object",
"required": [
"tier",
"rate_limit_remaining",
"processed_at"
],
"properties": {
"tier": {
"enum": [
"free",
"pro",
"enterprise"
],
"type": "string"
},
"processed_at": {
"type": "string"
},
"rate_limit_remaining": {
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"const": "unlimited"
},
{
"type": "string",
"const": "unknown"
}
]
}
},
"additionalProperties": false
},
"error": {
"type": "string"
},
"insights": {
"type": "array",
"items": {
"type": "string"
}
},
"self_url": {
"type": "string"
},
"error_code": {
"enum": [
"url_not_allowed",
"page_not_found",
"upstream_http_error",
"unsupported_content",
"upstream_unavailable",
"timeout",
"internal_error",
"page_blocked",
"page_unreadable"
],
"type": "string",
"description": "Vaste foutcode (nooit interne details)"
},
"self_score": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"self_matched": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"summary",
"category",
"confidence"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"_wm": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"category": {
"type": "string"
},
"full_text": {
"type": "string"
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"similarity": {
"type": [
"number",
"null"
]
},
"upgrade_hint": {
"type": "string"
},
"evidence_count": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
},
"competitor_url": {
"type": "string"
},
"competitor_score": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"delta_principles": {
"type": "object",
"required": [
"missing_on_self",
"missing_on_competitor"
],
"properties": {
"missing_on_self": {
"type": "array",
"items": {
"$ref": "#/properties/self_matched/items"
}
},
"missing_on_competitor": {
"type": "array",
"items": {
"$ref": "#/properties/self_matched/items"
}
}
},
"additionalProperties": false
},
"competitor_matched": {
"type": "array",
"items": {
"$ref": "#/properties/self_matched/items"
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Compare URLs against Proximens GEO Engine",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| topic * | string | |
| target_branche | string | one of ["local_services","digital_services","product_commerce","creative_professional","health_wellness","b2b_saas","universal"] |
| competitor_urls | array | |
| word_count_target | number |
{
"name": "proximens_geo_synthesize_brief",
"title": "Synthesize Content Brief from Proximens GEO Engine",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"topic"
],
"properties": {
"topic": {
"type": "string",
"maxLength": 200,
"minLength": 3
},
"target_branche": {
"enum": [
"local_services",
"digital_services",
"product_commerce",
"creative_professional",
"health_wellness",
"b2b_saas",
"universal"
],
"type": "string"
},
"competitor_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 3
},
"word_count_target": {
"type": "number",
"default": 1500,
"maximum": 5000,
"minimum": 300
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"brief_id",
"topic",
"suggested_structure",
"principles_to_address",
"estimated_word_count"
],
"properties": {
"_meta": {
"type": "object",
"required": [
"tier",
"rate_limit_remaining",
"processed_at"
],
"properties": {
"tier": {
"enum": [
"free",
"pro",
"enterprise"
],
"type": "string"
},
"processed_at": {
"type": "string"
},
"rate_limit_remaining": {
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"const": "unlimited"
},
{
"type": "string",
"const": "unknown"
}
]
}
},
"additionalProperties": false
},
"topic": {
"type": "string"
},
"brief_id": {
"type": "string",
"format": "uuid"
},
"schema_markup": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"rationale"
],
"properties": {
"type": {
"type": "string"
},
"rationale": {
"type": "string"
}
},
"additionalProperties": false
}
},
"faq_suggestions": {
"type": "array",
"items": {
"type": "object",
"required": [
"q",
"a_hint"
],
"properties": {
"q": {
"type": "string"
},
"a_hint": {
"type": "string"
}
},
"additionalProperties": false
}
},
"suggested_structure": {
"type": "object",
"required": [
"h1",
"sections"
],
"properties": {
"h1": {
"type": "string"
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"h2",
"key_points"
],
"properties": {
"h2": {
"type": "string"
},
"key_points": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"estimated_word_count": {
"type": "number"
},
"principles_to_address": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"summary",
"category",
"confidence"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"_wm": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"category": {
"type": "string"
},
"full_text": {
"type": "string"
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"similarity": {
"type": [
"number",
"null"
]
},
"upgrade_hint": {
"type": "string"
},
"evidence_count": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Synthesize Content Brief from Proximens GEO Engine",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| queries * | array | |
| category | string | one of ["technical","structured-data","content","ai-search","freshness","multimodal","user-signals","e-e-a-t","mobile","performance","query-intent","internal-linking","other"] |
| top_k_per_query | number |
{
"name": "proximens_geo_bulk_search",
"title": "Bulk Search Proximens GEO Engine",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"queries"
],
"properties": {
"queries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500,
"minLength": 3
},
"maxItems": 100,
"minItems": 2
},
"category": {
"enum": [
"technical",
"structured-data",
"content",
"ai-search",
"freshness",
"multimodal",
"user-signals",
"e-e-a-t",
"mobile",
"performance",
"query-intent",
"internal-linking",
"other"
],
"type": "string"
},
"top_k_per_query": {
"type": "number",
"default": 5,
"maximum": 10,
"minimum": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"results",
"total_queries",
"total_matches"
],
"properties": {
"_meta": {
"type": "object",
"required": [
"tier",
"rate_limit_remaining",
"processing_time_ms",
"processed_at"
],
"properties": {
"tier": {
"enum": [
"free",
"pro",
"enterprise"
],
"type": "string"
},
"processed_at": {
"type": "string"
},
"processing_time_ms": {
"type": "number"
},
"rate_limit_remaining": {
"anyOf": [
{
"type": "number"
},
{
"type": "string",
"const": "unlimited"
},
{
"type": "string",
"const": "unknown"
}
]
}
},
"additionalProperties": false
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"query",
"matches",
"count"
],
"properties": {
"count": {
"type": "number"
},
"query": {
"type": "string"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"summary",
"category",
"confidence"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"_wm": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"category": {
"type": "string"
},
"full_text": {
"type": "string"
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"similarity": {
"type": [
"number",
"null"
]
},
"upgrade_hint": {
"type": "string"
},
"evidence_count": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"tier_note": {
"type": "string",
"description": "Set when the per-call cap on unique principles withheld matches"
},
"total_matches": {
"type": "number"
},
"total_queries": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Bulk Search Proximens GEO Engine",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.