Skip to main content
Glama
papjuli

xkcdai

by papjuli

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
XKCDAI_DATA_DIRYesPath to the directory where comics.json, explain.json, embeddings.npy, and index.json are stored. Must be set since the host launches the server from an arbitrary working directory.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
find_xkcdA

Find xkcd comics semantically relevant to the current conversation.

Call this whenever an xkcd comic might enrich the conversation — when the discussion lands on a topic xkcd is famous for skewering (programming, science, statistics, relationships, the absurdity of standards, etc.).

Pass a concise description of the current topic or theme as context (a phrase or sentence works better than a whole transcript), e.g. "spending hours automating a task that was faster to do by hand" or "code finally compiling".

IMPORTANT — deciding whether to mention one. xkcd has a comic for almost every topic, so this tool will nearly always return something. A result being returned does NOT mean you should bring it up. Use the score as a signal and apply your own judgment about conversational fit: score >= 0.75 strong match — usually worth mentioning if it fits the moment 0.66 - 0.75 plausible — mention only if it genuinely lands < 0.66 weak/tangential — almost always better to stay silent Only one comic, at most, per topic — and only when it actually adds something. When in doubt, say nothing; a forced reference is worse than none.

When you do share one, cite it by number and title with its url, and quote the alt (mouseover) text — it's half the joke.

Returns a dict with a results list (num, title, score, url, image, alt, explain_url) and a count. An empty list means nothing cleared the floor.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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/papjuli/xkcdai'

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