CrawlForge MCP Server

serp_rank

Read-onlyIdempotent

Check organic Google rankings for any domain and keyword. Get the exact position, ranking URL, and every result placement in one request.

Instructions

Use this to check where a domain ranks in Google's ORGANIC results for a keyword - real SERP position, not Custom Search order. Returns the target's organic rank, the ranking URL, and every position it holds. Not for general search (search_web). Requires DataForSEO credentials and returns configured:false without them - do not retry in that case. Cost: 5 credits (0 when unconfigured). Example: serp_rank({keyword: "managed wordpress hosting", target: "dashboardhosting.com", location_name: "United States"})

Input Schema

TableJSON Schema

Name	Required	Description
`depth`	No	How many results to scan, 10-200 (default 20; DataForSEO bills ~$0.002 per 10 and gets slower the deeper it goes)
`device`	No	Device to emulate
`target`	Yes	Domain or URL to locate in the results (e.g. 'example.com')
`keyword`	Yes	The search query to check ranking for
`language_code`	No	Language code (e.g. 'en')
`location_code`	No	Numeric DataForSEO location code (overrides location_name)
`location_name`	No	Location, e.g. 'United States' or 'London,England,United Kingdom'

Output Schema

TableJSON Schema

Name	Required	Description
`url`	No	URL of the target's best-ranking result
`cost`	No	USD charged by DataForSEO for this lookup (separate from CrawlForge credits)
`note`	No	Present when configured=false, explains how to enable
`_cost`	No	Cost-transparency metadata (D3.5), present when injected into the text copy of the result
`found`	No	Whether the target appeared anywhere in the scanned SERP
`title`	No
`device`	No
`target`	No	Bare target domain, normalized
`keyword`	No
`results`	No	Top organic competitors as Google actually ranks them (capped)
`checkUrl`	No	Link to view the real SERP on DataForSEO
`location`	No
`position`	No	Best (lowest) organic rank; null = not within top `depth`
`checkedAt`	No
`configured`	No	False when DATAFORSEO_LOGIN/PASSWORD are unset — no rank was fabricated
`allPositions`	No	Every position the target holds on this SERP
`depthScanned`	No
`rankAbsolute`	No
`organicResults`	No
`seResultsCount`	No

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

Changed7 schema fields changedv6.0.0Sep 6, 2026

removedInput schema / additionalProperties
```
Removed value: -false
```
changedOutput schema / properties / _cost / additionalProperties
```
Previous value: -trueNew value: +{}
```
changedOutput schema / properties / allPositions / items / additionalProperties
```
Previous value: -trueNew value: +{}
```
removedOutput schema / properties / results / items / $ref
```
Removed value: -"#/properties/allPositions/items"
```
addedOutput schema / properties / results / items / additionalProperties
```
Added value: +{}
```

addedOutput schema / properties / results / items / properties

Added value: +{
+  "domain": {
+    "type": "string"
+  },
+  "position": {
+    "type": [
+      "number",
+      "null"
+    ]
+  },
+  "rankAbsolute": {
+    "type": [
+      "number",
+      "null"
+    ]
+  },
+  "snippet": {
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "title": {
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "url": {
+    "type": [
+      "string",
+      "null"
+    ]
+  }
+}

addedOutput schema / properties / results / items / type
```
Added value: +"object"
```

Changed1 schema field changedv5.0.5Aug 23, 2026

changedInput schema / properties / depth / description

Previous value: -"How many results to scan, 10-200 (100 = 1 page of cost)"New value: +"How many results to scan, 10-200 (default 20; DataForSEO bills ~$0.002 per 10 and gets slower the deeper it goes)"

Changed2 schema fields changedv5.0.4Aug 21, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "_cost": {
+      "additionalProperties": true,
+      "description": "Cost-transparency metadata (D3.5), present when injected into the text copy of the result",
+      "properties": {
+        "actual": {
+          "description": "Credits actually charged (0 in creator mode, half-rate on error)",
+          "type": "number"
+        },
+        "projected": {
+          "description": "Credits projected for this call before execution",
+          "type": "number"
+        },
+        "projection_note": {
+          "description": "Human-readable note about how the cost was projected",
+          "type": "string"
+        },
+        "remaining_credits": {
+          "description": "Credits remaining on the account after this call, if known",
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "allPositions": {
+      "description": "Every position the target holds on this SERP",
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "domain": {
+            "type": "string"
+          },
+          "position": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "rankAbsolute": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "snippet": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "title": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "checkUrl": {
+      "description": "Link to view the real SERP on DataForSEO",
+      "type": "string"
+    },
+    "checkedAt": {
+      "type": "string"
+    },
+    "configured": {
+      "description": "False when DATAFORSEO_LOGIN/PASSWORD are unset — no rank was fabricated",
+      "type": "boolean"
+    },
+    "cost": {
+      "description": "USD charged by DataForSEO for this lookup (separate from CrawlForge credits)",
+      "type": "number"
+    },
+    "depthScanned": {
+      "type": "number"
+    },
+    "device": {
+      "type": "string"
+    },
+    "found": {
+      "description": "Whether the target appeared anywhere in the scanned SERP",
+      "type": "boolean"
+    },
+    "keyword": {
+      "type": "string"
+    },
+    "location": {},
+    "note": {
+      "description": "Present when configured=false, explains how to enable",
+      "type": "string"
+    },
+    "organicResults": {
+      "type": "number"
+    },
+    "position": {
+      "description": "Best (lowest) organic rank; null = not within top `depth`",
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "rankAbsolute": {
+      "type": [
+        "number",
+        "null"
+      ]
+    },
+    "results": {
+      "description": "Top organic competitors as Google actually ranks them (capped)",
+      "items": {
+        "$ref": "#/properties/allPositions/items"
+      },
+      "type": "array"
+    },
+    "seResultsCount": {
+      "type": "number"
+    },
+    "target": {
+      "description": "Bare target domain, normalized",
+      "type": "string"
+    },
+    "title": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "url": {
+      "description": "URL of the target's best-ranking result",
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

First observedv4.10.0Jul 29, 2026

TDQS

A4.5/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish readOnly/idempotent/non-destructive safety, so the bar is lower; the description adds valuable extras: external DataForSEO dependency, credential requirement, unconfigured failure mode, cost implications (5 credits, 0 unconfigured), and a no-retry rule. It does not disclose rate limits or pagination, but those are not necessary for a read-only lookup with an output schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is tight and front-loaded: the core purpose appears first, followed by the sibling exclusion, operational caveat, cost, and example. Every sentence earns its place and none repeats the schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only external-SERP lookup with full schema coverage and an output schema, the description covers what an agent needs: purpose, scope, credentials, failure handling, cost, and example inputs. No critical behavioral or invocation context is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 7 parameters. The description mainly reinforces keyword/target semantics and gives a concrete example with location_name, but does not add much meaning beyond that. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and object: 'check where a domain ranks in Google's ORGANIC results for a keyword.' It explicitly distinguishes from Custom Search order and names the sibling search_web as the wrong tool for general search, so an agent can select it accurately.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit routing guidance: 'Not for general search (search_web).' It also supplies operational prerequisites (DataForSEO credentials), defines the unconfigured failure value (configured:false), and tells the agent not to retry in that case. An example invocation further clarifies expected usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mysleekdesigns/crawlforge-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server