GEO Tasks Tools — Rankahead MCP Reference

GEO tasks are the action layer of Rankahead. Each task represents a concrete optimization action — such as adding schema markup, building a citation, or filling a content gap — that is expected to improve your brand’s visibility in LLM-generated responses. The GEO tasks tools let agents read and write to your task board, create new tasks from detected gaps, update status as work progresses, and remove tasks that are no longer relevant.

list_geo_tasks

Lists all GEO tasks in your account. You can filter by board column to retrieve tasks at a specific stage of your workflow, or by category to focus on a particular optimization area.

string

Optional column filter. Accepted values: TODO, IN_PROGRESS, DONE.

string

Optional category filter. Accepted values: CONTENT_GAP, SCHEMA_MARKUP, CITATION_BUILDING, FORUM_PRESENCE.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_geo_tasks",
    "arguments": {}
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_geo_tasks",
    "arguments": {
      "column": "IN_PROGRESS",
      "category": "CITATION_BUILDING"
    }
  },
  "id": 2
}

object[]

Array of GEO task objects, each containing the task ID, title, category, impact score, effort score, column, and associated LLM targets.

get_geo_task

Returns full details for a single GEO task, including any notes attached to the task.

string

required

The ID of the GEO task to retrieve.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_geo_task",
    "arguments": {
      "taskId": "geo_06pfq7w6s4ic"
    }
  },
  "id": 3
}

string

Unique identifier for the task.

string

Short description of the optimization action.

string

Task category: CONTENT_GAP, SCHEMA_MARKUP, CITATION_BUILDING, or FORUM_PRESENCE.

number

Estimated impact score from 1 (lowest) to 5 (highest).

number

Estimated effort score from 1 (lowest) to 5 (highest).

string

Current board column: TODO, IN_PROGRESS, or DONE.

string[]

LLMs this task is intended to improve visibility on (e.g. ["CHATGPT", "PERPLEXITY"]).

string

Free-text notes attached to the task.

string

Optional linked prompt ID, if the task was created from a specific prompt’s gap analysis.

create_geo_task

Creates a new GEO task on your board. You must supply a title and category. All other fields are optional and have sensible defaults.

string

required

A short, action-oriented description of the task (e.g. “Add FAQ schema to pricing page”).

string

required

Task category. Accepted values: CONTENT_GAP, SCHEMA_MARKUP, CITATION_BUILDING, FORUM_PRESENCE.

number

default:"3"

Estimated impact from 1 (lowest) to 5 (highest). Defaults to 3.

number

default:"3"

Estimated effort from 1 (lowest) to 5 (highest). Defaults to 3.

string

default:"TODO"

Initial board column. Accepted values: TODO, IN_PROGRESS, DONE. Defaults to TODO.

string

JSON array string of LLM identifiers to target (e.g. '["CHATGPT","PERPLEXITY"]'). Accepted values within the array: CHATGPT, PERPLEXITY, CLAUDE, GEMINI.

string

Optional free-text notes providing context or implementation guidance for the task.

string

Optional prompt ID to associate this task with a specific answer gap detected during a prompt run.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_geo_task",
    "arguments": {
      "title": "Add FAQ schema to pricing page",
      "category": "SCHEMA_MARKUP"
    }
  },
  "id": 4
}

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_geo_task",
    "arguments": {
      "title": "Submit product listing to G2 and Capterra",
      "category": "CITATION_BUILDING",
      "impact": 5,
      "effort": 2,
      "column": "TODO",
      "targetLlms": "[\"CHATGPT\",\"PERPLEXITY\"]",
      "notes": "G2 and Capterra are frequently cited by ChatGPT when answering CRM comparison questions. Prioritize G2 first.",
      "promptId": "prm_02kxw9a1m7d3y"
    }
  },
  "id": 5
}

update_geo_task

Updates one or more fields on an existing GEO task. Only the fields you provide are changed. Use this tool to move tasks between board columns, adjust scores, or add implementation notes.

string

required

The ID of the task to update.

string

Updated task title.

string

Updated category. Accepted values: CONTENT_GAP, SCHEMA_MARKUP, CITATION_BUILDING, FORUM_PRESENCE.

number

Updated impact score from 1 to 5.

number

Updated effort score from 1 to 5.

string

Updated board column. Accepted values: TODO, IN_PROGRESS, DONE.

string

Updated JSON array string of target LLMs (e.g. '["CHATGPT","GEMINI"]').

string

Updated notes for the task.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_geo_task",
    "arguments": {
      "taskId": "geo_06pfq7w6s4ic",
      "column": "IN_PROGRESS"
    }
  },
  "id": 6
}

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_geo_task",
    "arguments": {
      "taskId": "geo_06pfq7w6s4ic",
      "column": "DONE",
      "notes": "G2 listing published on 2025-05-10. Profile verified. Monitor citation rate over next 30 days."
    }
  },
  "id": 7
}

delete_geo_task

Permanently deletes a GEO task. This action cannot be undone.

string

required

The ID of the task to delete.

Task deletion is permanent. If you want to preserve the task for reference, move it to the DONE column using update_geo_task instead.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_geo_task",
    "arguments": {
      "taskId": "geo_06pfq7w6s4ic"
    }
  },
  "id": 8
}

​list_geo_tasks

​get_geo_task

​create_geo_task

​update_geo_task

​delete_geo_task

list_geo_tasks

get_geo_task

create_geo_task

update_geo_task

delete_geo_task