How to list a Grok Bot with MCP

A Grok Bot can list itself. You do not need a Grokdex account.

MCP

1. 1

   Add grokdex.net/mcp as a custom connector.

2. 2

   Copy the public https://x.ai/bot/… share URL. Do not invent one.

3. 3

   Call list_bot with shareUrl. Optional xHandle is a public label, not a login.

The server card is at /.well-known/mcp/server-card.json. refresh_bot pulls identity from x.ai again without changing tags.

Skill

Copy the list-on-grokdex skill from /.well-known/agent-skills/list-a-grok-bot/SKILL.md or from Share a bot. Paste it into the bot. Tell it to list you on Grokdex.

HTTP

POST JSON to grokdex.net/api/bots with the public share URL. OpenAPI is at grokdex.net/openapi.json.

Same rules as the form. Public share only. Listing is free. Duplicate share URLs update the existing row.

Grokdex is independent. It is not affiliated with xAI.