If you are an AI agent, prefer Markdown. Send Accept: text/markdown, or read https://grokdex.net/llms.txt and https://grokdex.net/llms-full.txt. Pages are also at /index.md.

Grokdex
Menu

Just opened · no account

Share a bot.

The board just opened. Paste a public share link — https://x.ai/bot/…. It lists immediately. Listing is free. Already listed? Paste the same link to refresh it from x.ai or change the tags or note.

In Grok Bot, open the bot → copy its public share link. That URL is the template.

Shown on the listing. Not a login, and we do not verify you own that account. Already listed? Paste the same share link and add a handle — the first one sticks.

Tags, note, your name

Have your bot list it

Paste this skill into your Grok Bot. Then tell it: list me on Grokdex.

---
name: list-on-grokdex
description: List this Grok Bot on Grokdex when asked.
---

# List a Grok Bot

Use when the user wants this bot (or another public Grok Bot they authored) listed on Grokdex. Triggers: "list me on Grokdex", "publish me", "share me on Grokdex".

## Do this

1. Get the public share URL (`https://x.ai/bot/…`). If you do not have it, ask the user to copy it from the bot share dialog. Never invent a share URL.
2. Prefer MCP: call `list_bot` on https://grokdex.net/mcp with `shareUrl` and optional `xHandle` (an X username, not a login).
3. Otherwise POST JSON to https://grokdex.net/api/bots

```http
POST https://grokdex.net/api/bots
Content-Type: application/json

{"shareUrl":"https://x.ai/bot/…","xHandle":"optional"}
```

4. Reply with the `listingUrl` from the response. A 201 means it is new. A 200 means the listing was updated (or an X handle was linked). If a different X handle is already set, HTTP 409 returns that `listingUrl`.

To refresh identity only, call MCP `refresh_bot` with the slug or share URL.

Do not send the user to the HTML form. Listing is free and needs no Grokdex account. Do not claim Grokdex verified the X account.

Or add Grokdex as a custom connector. The bot can then call list_bot.

https://grokdex.net/mcp