protogrid

Search / io.github.papjuli/xkcdai

xkcd Comic Suggester

R0· no sign-in

Suggests a relevant xkcd comic during a conversation, via semantic search over every comic.

v0.2.0 · active · repository · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality76good
Trust91of 100
Uptime, 30 days100%
Latency p50349 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "xkcdai": {
      "type": "http",
      "url": "https://xkcdai.onrender.com/mcp"
    }
  }
}
claude mcp add --transport http xkcdai https://xkcdai.onrender.com/mcp
[mcp_servers.xkcdai]
url = "https://xkcdai.onrender.com/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xkcdai": {
      "type": "remote",
      "url": "https://xkcdai.onrender.com/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "xkcdai": {
      "type": "http",
      "url": "https://xkcdai.onrender.com/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=xkcdai&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8veGtjZGFpLm9ucmVuZGVyLmNvbS9tY3AifQ%3D%3D"
}
{
  "servers": {
    "xkcdai": {
      "type": "http",
      "url": "https://xkcdai.onrender.com/mcp"
    }
  }
}
{
  "mcpServers": {
    "xkcdai": {
      "httpUrl": "https://xkcdai.onrender.com/mcp"
    }
  }
}
extensions:
  "xkcdai":
    enabled: true
    name: "xkcdai"
    type: streamable_http
    uri: "https://xkcdai.onrender.com/mcp"
    timeout: 300

Quality 76 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene64 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • warn
    tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: find_xkcd (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
  • pass
    tools.token_costabout 431 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

1 tools, about 431 tokens to load them all · tool set 94abf9601efe · checked 2026-10-20 14:54 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 91 / 100

provenance80
liveness100
freshness85
hygiene100

+repository +namespace-matches-repo +reachable +uptime-100% ~updated-74d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://xkcdai.onrender.com/mcp streamable-httpnoneyes100%349 ms2025-11-252026-10-20

Tools (1)

find_xkcdFind 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 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.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.papjuli/xkcdai",
  "title": "xkcd Comic Suggester",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://xkcdai.onrender.com/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "0.2.0",
  "repository": {
    "url": "https://github.com/papjuli/xkcdai",
    "source": "github"
  },
  "description": "Suggests a relevant xkcd comic during a conversation, via semantic search over every comic."
}