# get_keyword_gap

Get the keyword gap for a cataloged domain: phrases a tracked competitor holds a position for in our stored captures where this domain holds none ("absent"), or holds one at least 20 places further back ("behind"). Claimed domains only, computed from captures already on disk. Nothing is fetched and nothing is spent. The stored lists are a SAMPLE of each domain's footprint (the top rows a capture kept), so absence here is absence from our sample, never from public search; the response carries that sentence and it must be repeated wherever the result is shown. Positions are ranking footprint, never traffic.

Agent View of the PolicyLayer registry record for `get_keyword_gap`. HTML page: https://policylayer.com/tools/com-groundedaeo-grounded-aeo/get-keyword-gap

## Facts

- Tool: `get_keyword_gap`
- Server: Grounded Aeo (`https://groundedaeo.com/api/mcp`) — https://policylayer.com/tools/com-groundedaeo-grounded-aeo.md
- Homepage: https://github.com/https://groundedaeo.com/api/mcp
- Risk category: Read (Low risk)
- Registry record: grade D, identity unverified
- Server auth posture: open
- Server rate-limited: no
- Parameters: 1 (1 required)
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `domain` | string | yes | Company domain, e.g. acme.com |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_keyword_gap",
    "arguments": {
      "domain": "<domain>"
    }
  }
}
```

## Why get_keyword_gap is rated Low

This tool performs SEO analysis by comparing keyword rankings between domains using pre-computed, stored data. It retrieves and queries existing capture data to identify keyword gaps. No data is modified, created, deleted, or written; no external operations are triggered; and no financial transactions occur. The operation is purely informational retrieval from an internal data store.

From the tool's own definition: "Tool description states: 'Get the keyword gap...', 'Nothing is fetched and nothing is spent', 'computed from captures already on disk'."

## Use case

AI agents call get_keyword_gap to retrieve information from Grounded Aeo without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Grounded Aeo:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "get_keyword_gap": {}
  }
}
```

## Other tools on Grounded Aeo (13)

- `run_audit` — Execute — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/run-audit.md
- `check_aeo_record` — Read — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/check-aeo-record.md
- `check_serp` — Read — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/check-serp.md
- `get_citations` — Read — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/get-citations.md
- `get_cited_domains` — Read — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/get-cited-domains.md
- `get_company_facts` — Read — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/get-company-facts.md
- `get_competitive_snapshot` — Read — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/get-competitive-snapshot.md
- `get_engine_visibility` — Read — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/get-engine-visibility.md
- `get_fact` — Read — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/get-fact.md
- `get_llms_txt` — Read — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/get-llms-txt.md
- `propose_briefs` — Read — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/propose-briefs.md
- `search_catalog` — Read — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/search-catalog.md
- `generate_free_record` — Write — https://policylayer.com/tools/com-groundedaeo-grounded-aeo/generate-free-record.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=com-groundedaeo-grounded-aeo · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/com-groundedaeo-grounded-aeo