Search / io.github.worklore/worklore
worklore
R0· no sign-inSearch worklore stories and x-ray any skill or story capability tier (T0-T4) before you run it.
v0.7.1 · active · repository · descriptor JSON · versions
Search / io.github.worklore/worklore
R0· no sign-inSearch worklore stories and x-ray any skill or story capability tier (T0-T4) before you run it.
v0.7.1 · active · repository · descriptor JSON · versions
{
"mcpServers": {
"worklore": {
"type": "http",
"url": "https://worklore.dev/mcp"
}
}
}claude mcp add --transport http worklore https://worklore.dev/mcp[mcp_servers.worklore]
url = "https://worklore.dev/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"worklore": {
"type": "remote",
"url": "https://worklore.dev/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"worklore": {
"type": "http",
"url": "https://worklore.dev/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=worklore&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vd29ya2xvcmUuZGV2L21jcCJ9"
}{
"servers": {
"worklore": {
"type": "http",
"url": "https://worklore.dev/mcp"
}
}
}{
"mcpServers": {
"worklore": {
"httpUrl": "https://worklore.dev/mcp"
}
}
}extensions:
"worklore":
enabled: true
name: "worklore"
type: streamable_http
uri: "https://worklore.dev/mcp"
timeout: 300
protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_length1 tools have descriptions over 1,024 characters, which crowds the contexttools.schemasevery tool has an object input schematools.annotations8 of 8 tools declare readOnlyHint or destructiveHinttools.directory_hints3 of 8 tools declare all four hints; missing: check_capability (idempotentHint); search_stories (idempotentHint); suggest_for_project (idempotentHint); …tools.token_costabout 2,246 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes, stability.rug_pulltool history recorded for 4 of the 7 days neededdeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packagepublish_storychangedoutput schemareport_checkchangedoutput schemareport_reproductionchangedoutput schemasuggest_for_projectchangedoutput schemasearch_storieschangedoutput schemaget_storychangedoutput schemacheck_capabilitychangedoutput schemaFull history: list_changes · trend: quality JSON.
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.
+repository +namespace-matches-repo +reachable +uptime-100% +updated-4d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://worklore.dev/mcp streamable-http | none | yes | 100% | 359 ms | 2025-06-18 | 2026-10-19 |
check_capabilityread-only | Disclose what an agent Skill or worklore story CAN DO before you run it: a capability tier T0-T4 bound to a content sha256, with findings that carry file:line evidence, PLUS a separate list of behavioral red flags (prompt-injection / deception / exfiltration-intent / safety-bypass phrasings) for a human to review. This is blast-radius disclosure and triage, never a 'safe' verdict. Prefer a `url` over pasting a file: a skill on GitHub (github.com or raw.githubusercontent.com, up to 200 KB) needs no sign-in, and you do not have to copy the whole file into the call. Other URLs need a signed-in session. If you paste `text`, also pass `expected_sha256` (the file's sha256, e.g. `shasum -a 256 SKILL.md`): a copy that changed on the way is reported instead of scanned. `received` says exactly what was scanned. |
edit_storydestructive | Revise a worklore story the signed-in account PUBLISHED — only its author can edit it. Call get_story first, then show the human a before/after diff of your change and get their EXPLICIT approval before calling this; never edit on your own initiative. Send the COMPLETE revised story as `markdown` (frontmatter + '# title' + narrative + '## Reproduce this'), not a fragment. Keep the frontmatter `date` exactly as it is: it records when the work happened, and a revision never moves it. Say what kind of edit this is: 'rephrase' (same claims, better wording), 'addition' (new detail, nothing was wrong), or 'correction' (something in the story was WRONG — a step, a claim, a result). If anything was wrong, it is a correction: never hide a correction as a rephrase. A correction requires a one-line `note` saying what was wrong, and notifies everyone who reported reproducing the story. `source` optionally credits what prompted the revision (an https URL). The new text REPLACES the old (worklore keeps no copy of earlier text), while a record of this revision — when, what kind, the note — is appended to the story's public history. |
get_storyread-only | Fetch one worklore story by slug — its full markdown (narrative + the 'Reproduce this' contract your agent would run) WITH its capability disclosure attached (tier + findings), so you see what it can do before applying it. Read the capability first; run check_capability on the live artifacts before executing. After you apply the story to the user's task, call report_reproduction with an honest result to record it. |
publish_story | Publish a NEW worklore story as the signed-in account. worklore stories are PUBLIC and honest, so before you call this you MUST show the human the complete draft — the title, the first-person narrative, and the 'Reproduce this' contract — and get their EXPLICIT approval. Never publish on your own initiative and never invent details. Provide the full story as `markdown` (frontmatter with title/date/tags/type/reproducible, then '# title', the narrative, then '## Reproduce this' with prerequisites/inputs/steps/verify) — call get_story on an existing story first to match the format — OR provide the structured fields title + narrative (+ reproduce, tags, type, stack) and the server assembles it. SANITIZE: no secrets, employer internals, client names, or private URLs. Returns the live URL and capability tier. |
report_check | Record the result of a story's read-only 'Check if this applies to you' section, run in the user's own project (attributed to the signed-in account). Run ONLY that check — change nothing, apply no fix. First decide whether it applies at all: if the project does not match the check's preconditions, do NOT call this — 'not applicable' is never recorded. Otherwise report 'has_problem' or 'no_problem', honestly. One counted result per person per story; a later report replaces the earlier one. Only stories whose get_story result has has_check: true can be checked. |
report_reproduction | Call this right after you apply a worklore story's steps to the user's own task, to record the reproduction (attributed to the signed-in account). Use an honest result: 'worked', 'partial' (you produced the output but it isn't verified yet), or 'failed' — all are useful. One counted report per person per story; repeats are acknowledged, not doubled. Never report a story you did not apply. |
search_storiesread-only | Search worklore stories by keyword across title, summary, tags and stack. Returns matches with their capability tier. |
suggest_for_projectread-only | Given a short description of the current project (stack, what you're building, recent problems), suggest up to 3 worklore stories worth reproducing here, with why each fits and its tier. |
Schemas: list_tools.
{
"name": "io.github.worklore/worklore",
"_meta": {
"io.modelcontextprotocol.registry/publisher-provided": {
"io.github.sidneybissoli/mcp-surface": {
"form": "mcp-surface/1",
"spec": "https://github.com/SidneyBissoli/mcp-br-commons/blob/main/packages/mcp-surface/SPEC.md",
"declared": {
"sha256": "c16f2f3e0ad105fbad20b8496f93bfdd79ddf7a7062933a772228781373ff1aa",
"lockedAt": "0.7.1"
},
"endpoint": "https://worklore.dev/mcp",
"anonymous": {
"call": {
"name": "check_capability",
"arguments": {
"text": "echo mcp-surface"
}
},
"sha256": "ade1bd429bdfc63453a924614520010bb782ffd8d24fdd6483aa17d5b36b61a4",
"answers": {
"ping": true,
"initialize": true,
"tools/call": true,
"tools/list": true,
"prompts/list": true,
"resources/list": true,
"resources/templates/list": true
}
}
}
}
},
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://worklore.dev/mcp",
"type": "streamable-http"
}
],
"version": "0.7.1",
"repository": {
"url": "https://github.com/worklore/worklore-mcp",
"source": "github"
},
"description": "Search worklore stories and x-ray any skill or story capability tier (T0-T4) before you run it."
}