Skip to main content
Glama
vinsenzo83

RECLUSE Spider MCP Server

by vinsenzo83

๐Ÿ•ธ๏ธ RECLUSE

npm

An autonomous detectโ†’fixโ†’verify loop for the bugs that hide in your system's seams. MCP server + GitHub Action + a shared bug-corpus.

The recluse bites the bugs that hide in the seams.

When you vibe-code, writing is fast but debugging is slow โ€” you didn't write the code, so you don't know where it broke. And the bugs that actually bite in production usually aren't in one file; they live in the seams between subsystems: a value written in cents and read as dollars, an auth check that passes on NULL, an RLS policy that leaks every row, a SECURITY DEFINER function anyone can call because the grant went to PUBLIC.

RECLUSE traces those seams (producer โ†’ store โ†’ consumer), catches the mismatch with live evidence, dispatches a fixer, re-verifies โ€” then pools every caught pattern into a shared corpus so the next project catches the same trap at round-zero.

โ†’ Live page & corpus: https://eduverse-ai.app/recluse


What it does โ€” a closed loop

WEB (detect) โ†’ CATCH (contract mismatch) โ†’ SPIDER (autonomous fix) โ†’ RE-WEAVE (verify) โ†’ loop until ๐Ÿ”ด = 0
  • WEB โ€” fan out read-only QC agents with different viewpoints (security, data/payment, integration contracts). One reviewer's blind spot is another's catch.

  • CATCH โ€” where a producer/consumer contract tears, report it with the exact coordinate (file:line, constraint, RLS policy) and a severity.

  • SPIDER โ€” dispatch a fixer agent per finding into an isolated git worktree; several fix in parallel without collision. Only the orchestrator merges โ€” detectors stay read-only.

  • RE-WEAVE โ€” re-run the fixed strand and its neighbors to prove no regression. Loop until clean.

The orchestration (fan-out, dedup, dispatch, re-weave) is deterministic code โ€” a plain loop, not model-driven. Only the spiders (detect/fix) are LLM calls.

What it caught (real, on a live app)

Run against a production Next.js + Supabase/Postgres app, it found privilege-escalation bugs a static review had passed:

  • a SECURITY DEFINER function callable by anon, because REVOKE EXECUTE ... FROM anon is a no-op when the grant is to PUBLIC;

  • a plpgsql guard bypassed by NULL three-valued logic โ€” NULL OR false is NULL, which IF NOT treats as false, so the guard's exception never fired;

  • a SECURITY DEFINER view that let anon write through it, bypassing RLS on the base table.

All three only reproduced against a live endpoint โ€” reading the source called them safe. Each is now a built-in detection signal (spider_signals) with the exact query to reproduce it โ€” alongside curriculum order-integrity (band inversion / cyclic prerequisites), per-user-limit anonymous farming, stream-budget 502s, and event producerโ†”consumer contract drift.


Related MCP server: acta-mcp

Quickstart

โ‘  MCP server โ€” for your editor (Claude, Cursor, any MCP client)

One line, no clone โ€” published on npm:

{ "mcpServers": { "recluse": {
  "command": "npx",
  "args": ["-y", "recluse-mcp"],
  "env": { "SPIDER_CORPUS_API": "https://eduverse-ai.app/api/corpus" }
} } }

Tools: spider_plan ยท spider_classify_tier ยท spider_checklist ยท spider_signals (detection query/grep per bug class) ยท spider_record_pattern (local + shared contribution) ยท spider_pull_corpus (collective pull, verified-first). Resources: spider://checklist ยท spider://queries ยท spider://corpus ยท spider://blackbox.

Knowledge is built into the server โ€” the checklist, contract queries, and a seed corpus of live-verified bug classes ship inside the package, so it works standalone. If you also run the spiderweb-qc skill, its richer reference files are picked up automatically (set SPIDER_REF_DIR).

โ‘ก GitHub Action โ€” gate every PR (blocks on ๐Ÿ”ด)

# .github/workflows/recluse.yml
name: RECLUSE
on:
  pull_request:
    branches: [main]
jobs:
  weave:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }
      - uses: vinsenzo83/recluse@v1.1
        with: { base: origin/${{ github.base_ref }} }
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

Without a key it runs in advisory mode (known-trap checklist, non-blocking). With ANTHROPIC_API_KEY it does a real weave on the diff, blocks on ๐Ÿ”ด, and contributes new patterns to the corpus.


Spider tiers โ€” resource by criticality

Not every path deserves Opus. Tier by risk:

Spider

Model

Scope

Verification

๐Ÿ•ท๏ธ King

Opus

payments ยท auth ยท GDPR ยท data loss ยท secrets

adversarial multi-vote + re-weave

๐Ÿ•ธ๏ธ Mid

Sonnet

business logic ยท contracts ยท i18n ยท gating

single + one refute pass

๐Ÿœ Baby

Haiku

docs ยท dead code ยท lint

single pass

So you're not paying Opus rates to check a comment โ€” and the paths where a false negative is expensive get the most scrutiny.


The shared corpus

Every caught bug is distilled into a stack-keyed pattern (detection signal + fix principle) and pooled. A new project checks known traps at round-zero โ€” the more it's used, the thicker the net.

  • Scrub-first: file paths, code literals, secrets (keys / JWT / high-entropy), emails, URLs, IPs are stripped before anything is shared; anything still suspicious is rejected. Only the generalized technique leaves your machine.

  • Anonymous: contributors/projects are stored as irreversible hashes โ€” no identity, no raw text.

  • Consensus: a pattern needs 3 independent contributors before it's marked verified.

Corpus API (base = SPIDER_CORPUS_API)

  • POST /patterns {klass,name,signal,fix,tags?,severity?,tier?} โ†’ scrub ยท dedup ยท trust accrual (rate-limited per IP)

  • GET /patterns?tags=postgres,payment&class=unit&verified=1&limit=50 โ†’ pull the corpus (verified=1 = consensus-verified only, for production use)

Contributing is open โ€” pick a contributor token, POST. No signup, no key required (the token is your anonymous identity, not a credential).


Honest limitations

  • Early (v0.1.1), best-tested on Next.js / Supabase / Postgres โ€” other stacks have thinner coverage until the corpus fills in.

  • Running it costs tokens. The tool is free to use, but a full weave spawns model calls (Opus on critical paths). It's not free to run.

  • Not open-source. The MCP client is on npm and the repo is source-available, but not OSI-licensed; the corpus backend is a hosted, closed service. A free tool, not an open one.

  • "Live evidence only" is the rule, not a proof. The model can still be wrong โ€” the re-verify step is the guard, not a guarantee.


Principles

No fabrication (live evidence only) ยท scrub-first (zero code/secret leakage) ยท opt-in & anonymous ยท detection = read-only, fixes = isolated spiders.

Repo layout

src/index.js       # MCP server (stdio)
cli/recluse.mjs    # CI weave CLI
action.yml         # GitHub Action

The shared corpus is a hosted service (https://eduverse-ai.app/api/corpus); its backend (schema, scrub pipeline, ingestion) is closed-source.

License

UNLICENSED (proprietary). Free to use; not open-source.

Available Tools

6 tools
spider_checklistA

์ฐจ์›๋ณ„ ์ „์ˆ˜ ์ฒดํฌ๋ฆฌ์ŠคํŠธ(์ฆ๊ฑฐ ์—†์ด PASS ๊ธˆ์ง€)๋ฅผ ๋ฐ˜ํ™˜. ํŒŒ์ผ ๋ถ€์žฌ ์‹œ ๋‚ด์žฅ ์ฒดํฌ๋ฆฌ์ŠคํŠธ + ์„ธ์…˜ ์‹ค์ฆ ๊ทธ๋ฌผ์ฝ”(๊ถŒํ•œ์ƒ์Šนยท์ˆœ์„œยท๋น„์šฉยท์ด๋ฒคํŠธ) ๋ณ‘ํ•ฉ.

ParametersJSON Schema
NameRequiredDescriptionDefault
dimensionNo์ธ์ฆ/๋ฐ์ดํ„ฐ/๋‹จ์œ„/๋Š๊ธด๊ณ ๋ฆฌ/๊ถŒํ•œ๊ฒฝ๊ณ„/ํด๋ฐฑ/๋Ÿฐํƒ€์ž„/์ˆœ์„œ/๋น„์šฉ/์ด๋ฒคํŠธ ๋“ฑ

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, description provides behavioral context: fallback to built-in checklist when file is missing, and merging with session verification data (privilege escalation, order, cost, events). However, it does not mention side effects, auth requirements, or whether the tool is read-only.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The single sentence conveys the tool's purpose and key behavior efficiently, though it is somewhat dense and could benefit from clearer structure or bullet points for readability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema and one optional parameter, the description explains the output nature (checklist with evidence) and fallback logic. However, it does not clarify that the dimension parameter is optional or what happens when omitted, leaving some ambiguity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% but description adds enumeration of dimension values (์ธ์ฆ/๋ฐ์ดํ„ฐ/๋‹จ์œ„/๋Š๊ธด๊ณ ๋ฆฌ/๊ถŒํ•œ๊ฒฝ๊ณ„/ํด๋ฐฑ/๋Ÿฐํƒ€์ž„/์ˆœ์„œ/๋น„์šฉ/์ด๋ฒคํŠธ ๋“ฑ) that are not present in the schema, enhancing parameter understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states it returns a per-dimension full checklist requiring evidence, and merges built-in checklist with session verification meshes. It is specific about the resource and verb, and distinguishes from sibling tools like spider_plan or spider_classify_tier by focusing on checklist generation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives such as spider_plan or spider_signals. Usage is only implied from the description, with no conditions, prerequisites, or exclusions stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

spider_classify_tierA

finding์„ King/Mid/Baby ๊ฑฐ๋ฏธ๋กœ ๋ถ„๋ฅ˜ํ•˜๊ณ  ๋ชจ๋ธยท๊ฒ€์ฆํ‘œ์ˆ˜๋ฅผ ๋ฐ˜ํ™˜. ์ˆ˜์ • ๊ฑฐ๋ฏธ ๊ธ‰ํŒŒ ์ „ ํ˜ธ์ถœ. ๋น„์šฉยท๊ถŒํ•œ์ƒ์Šนยท์ˆœ์„œ๋ฌด๊ฒฐ์„ฑ ๊ฒฝ๋กœ ๋ฐ˜์˜.

ParametersJSON Schema
NameRequiredDescriptionDefault
areaYes์˜์—ญ ํ‚ค์›Œ๋“œ(payment, definer, budget, order, event ๋“ฑ)
severityNo

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It mentions that the tool reflects cost, privilege escalation, and order integrity path, which adds specific behavioral context. However, it does not clarify if the tool modifies data (though '๋ถ„๋ฅ˜' and '๋ฐ˜ํ™˜' suggest read-only) or provide details on side effects or security implications.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, front-loaded with the main action, and contains no unnecessary words. Every sentence provides value: purpose, when to use, and behavioral context. Excellent conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description gives the core purpose and usage context but lacks details on the return format (model/verification key count) and does not fully explain how parameters like 'severity' influence behavior. Given the absence of output schema and annotations, more completeness would be beneficial.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 50% (only 'area' has a description). The tool description does not add any extra meaning beyond what the schema provides; it does not explain the 'severity' parameter or elaborate on the usage of 'area'. This leaves the undocumented parameter unclear.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's action: classifying findings into King/Mid/Baby spiders and returning model/verification counts. It also mentions the context of use (before dispatching modified spiders), providing a specific verb and resource. However, it does not explicitly distinguish this from siblings, though the siblings have different purposes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly states when to use the tool ('์ˆ˜์ • ๊ฑฐ๋ฏธ ๊ธ‰ํŒŒ ์ „ ํ˜ธ์ถœ' - call before dispatching modified spiders). It does not provide when-not-to-use or alternatives, but the context is clear and the sibling tools are distinct in function.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

spider_planB

๋Œ€์ƒ์— ๋Œ€ํ•œ ๊ฑฐ๋ฏธ์ค„ ๊ฒ€์ฆ ๊ณ„ํš์„ ๋ฐ˜ํ™˜: ๋˜์งˆ ๊ฑฐ๋ฏธ(์ฐจ์›ยท๋“ฑ๊ธ‰ยท๋ชจ๋ธ), ์šฐ์„  ์ ๊ฒ€ํ•  ํ•™์Šต ํŒจํ„ด, ์ ˆ๋Œ€์›์น™. ๋ผ์šด๋“œ ์‹œ์ž‘ ์‹œ ํ˜ธ์ถœ.

ParametersJSON Schema
NameRequiredDescriptionDefault
targetYes๊ฒ€์ฆ ๋Œ€์ƒ(๋ ˆํฌ/๊ธฐ๋Šฅ/๋ฐฐํฌ ๋ฒ”์œ„)
thoroughNotrue๋ฉด ๊ฑฐ๋ฏธ ์ˆ˜โ†‘ยท๋‹ค์ˆ˜๊ฒฐ ๊ฐ•ํ™”

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It does not mention side effects, idempotency, rate limits, or authentication needs, leaving significant gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, well-structured sentence that front-loads the purpose. It is concise without being terse, though it could be more efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema exists, so the description should describe the return structure. It lists components but lacks detail on format or fields, leaving the agent with an incomplete picture.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with both parameters described. The description adds high-level context (e.g., 'spiders to throw') but does not significantly enhance meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool returns a verification plan for a target, specifying components like spiders, learning patterns, and principles. It distinguishes itself from siblings by focusing on planning rather than classification or checklist.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It mentions 'call at round start,' providing timing context, but lacks explicit guidance on when not to use or alternatives among sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

spider_pull_corpusA

๊ณต์œ  corpus(์ง‘๋‹จ ๊ฑฐ๋ฏธ ๋‘๋‡Œ)์—์„œ ๊ฒ€์ฆ๋œ ํŒจํ„ด์„ ๊ฐ€์ ธ์˜จ๋‹ค. verified ์šฐ์„ ยทtag/klass ํ•„ํ„ฐ. ์›๊ฒฉ ๋ฏธ์„ค์ •/์‹คํŒจ ์‹œ ๋‚ด์žฅ corpus๋กœ graceful ํด๋ฐฑ. ๋ผ์šด๋“œ ์‹œ์ž‘ ์‹œ ์•Œ๋ ค์ง„ ํ•จ์ • ์šฐ์„  ์ ๊ฒ€์šฉ.

ParametersJSON Schema
NameRequiredDescriptionDefault
tagsNo์Šคํƒ ํƒœ๊ทธ ์‰ผํ‘œ(postgres,nextjs,payment ๋“ฑ)
klassNo
limitNo
verifiedNotrue(๊ธฐ๋ณธ)=ํ•ฉ์˜๊ฒ€์ฆ๋œ ํŒจํ„ด ์šฐ์„ . false=๋ฏธ๊ฒ€์ฆ ํฌํ•จ

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description discloses key behaviors: verified priority, filtering by tag/klass, and graceful fallback to internal corpus. However, with no annotations, it omits details like authentication, rate limits, or response format, which are important for a pull operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise, with two sentences that front-load the purpose and then provide additional details. No extraneous words or repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 4 parameters, no output schema, and no annotations, the description covers the core functionality but lacks details on return format, pagination, or the nature of the remote corpus, leaving some gaps for a fully autonomous agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 50% (tags and verified have descriptions, klass and limit do not). The description does not add any new parameter semantics beyond what is already in the schema, failing to compensate for the undocumented parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's verb 'pull' and resource 'shared corpus', and specifies filtering by tag/klass and verified priority, distinguishing it from siblings like spider_record_pattern which presumably records patterns.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It specifies a concrete use case: 'for checking known traps at round start'. However, it does not explicitly state when not to use it or provide alternatives, leaving some ambiguity about broader applicability.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

spider_record_patternB

์ด๋ฒˆ ๋ผ์šด๋“œ์— ์žก์€ ๋ฒ„๊ทธ๋ฅผ ํ•™์Šต corpus์— 1์ค„ ํŒจํ„ด์œผ๋กœ ์ฆ๋ฅ˜ ์ถ”๊ฐ€(๋‹ค์Œ ๋ผ์šด๋“œ์— ๋จผ์ € ์ ๊ฒ€). ์‹ค์ œ๋กœ ์žก์€ ๊ฒƒ๋งŒ.

ParametersJSON Schema
NameRequiredDescriptionDefault
fixYes์ˆ˜์ • ์›์น™
hitYes์ ์ค‘ ์˜ˆ์‹œ(ํ”„๋กœ์ ํŠธยท๋‚ ์งœยทfile:line)
nameYes์งง์€ ์ด๋ฆ„
tagsNo์Šคํƒ ํƒœ๊ทธ ์‰ผํ‘œ(postgres,stream,curriculum ๋“ฑ)
klassYes๋ฒ„๊ทธ ํด๋ž˜์Šค(๋‹จ์œ„/์ œ์•ฝยท๋Š๊ธด๊ณ ๋ฆฌยท๊ถŒํ•œ๊ฒฝ๊ณ„ ๋“ฑ)
signalYesํƒ์ง€ ์‹ ํ˜ธ โ€” ์–ด๋–ค ์ฟผ๋ฆฌ/grep/์ฝ”๋“œ์œ„์น˜๋กœ ์žก๋Š”๊ฐ€

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must fully disclose behavior. It mentions adding to a corpus and being checked later, but it does not describe side effects (e.g., overwrite behavior, deduplication), input validation, return values, or error conditions. The description is too minimal for a tool with 6 parameters.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise with two short sentences, no wasted words, and immediately front-loads the action. It earns its place without any fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (6 parameters, no output schema, no annotations, multiple siblings), the description lacks important context: it does not mention prerequisites (e.g., an existing corpus), the format or structure of the one-line pattern, what the tool returns, or how it integrates with the sibling tools. It is insufficient for a developer to fully understand usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, with each parameter having a clear Korean description. The tool description adds no additional meaning or context beyond what the schema already provides, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: to distill and add bug patterns caught in the current round to a learning corpus as one-line patterns, to be checked first in the next round. It uses specific verbs and resources, and the restriction 'only actually caught ones' adds clarity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies when to use (after catching bugs in the round) but provides no guidance on when not to use or how this tool differs from siblings like spider_checklist, spider_signals, or spider_pull_corpus. No explicit alternatives or exclusions are given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

spider_signalsA

์‹ค์ฆ ๋ฒ„๊ทธ ํด๋ž˜์Šค์˜ ํƒ์ง€ ์‹ ํ˜ธ(๋ผ์ด๋ธŒ ์ฟผ๋ฆฌ/grep)์™€ ์ˆ˜์ • ์›์น™์„ ๋ฐ˜ํ™˜. klass/tier/tag๋กœ ํ•„ํ„ฐ. ๊ณ„ํš ํ›„ ์ด ์‹ ํ˜ธ๋ฅผ ๊ทธ๋Œ€๋กœ ์‹คํ–‰ํ•ด ์ฆ๊ฑฐ๋ฅผ ์ˆ˜์ง‘ํ•˜๋ผ.

ParametersJSON Schema
NameRequiredDescriptionDefault
tagNo์Šคํƒ ํƒœ๊ทธ(postgres, stream, curriculum ๋“ฑ)
tierNo
klassNo๋ฒ„๊ทธ ํด๋ž˜์Šค ๋ถ€๋ถ„์ผ์น˜(๊ถŒํ•œ๊ฒฝ๊ณ„/์ˆœ์„œ๋ฌด๊ฒฐ์„ฑ/๋น„์šฉ๊ณต๊ฒฉ/์ด๋ฒคํŠธ๊ณ„์•ฝ/๋‹จ์œ„ ๋“ฑ)

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states the tool returns detection signals and fix principles, implying a read-only operation. However, it does not detail output format, side effects, or prerequisites, limiting transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences in Korean, tightly packed with purpose and usage guidance. No redundant information; every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has 3 optional parameters, no output schema, and no annotations. The description covers what it returns and when to use it, but omits output structure and behavioral details like idempotency or rate limits. Adequate for basic use but not fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 67% (tag and klass have descriptions; tier lacks one). The description adds that parameters are filters, which aligns with schema. However, the missing description for tier enum values (king/mid/baby) is a gap that the description does not fill.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool returns detection signals and fix principles for empirical bug classes, with filtering by klass/tier/tag. It distinguishes from siblings like spider_plan (planning) and spider_pull_corpus (pulling corpus) by emphasizing execution after planning.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly says 'after planning, execute these signals as-is to collect evidence,' providing clear context for when to use the tool. It also mentions filtering parameters. However, it does not explicitly exclude use cases or name alternatives among siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 6 tool updatesv0.2.0
    • First observedspider_checklist
    • First observedspider_classify_tier
    • First observedspider_plan
    • First observedspider_pull_corpus
    • First observedspider_record_pattern
    • First observedspider_signals

TDQS

A3.7/5.0
Disambiguation5/5

Each tool targets a distinct step in the spider verification workflow: planning, classification, checklist, signals collection, pattern recording, and corpus retrieval. There is no overlap in functionality.

Naming Consistency4/5

All tools use the 'spider_' prefix and underscore separators, but some names are verb_noun (e.g., spider_plan, spider_record_pattern) while others are noun-only (e.g., spider_checklist, spider_signals). This minor inconsistency prevents a perfect score.

Tool Count5/5

With 6 tools, the set is well-scoped for a specialized verification server. Each tool earns its place without being redundant or excessive for the domain.

Completeness4/5

The tools cover the core lifecycle: planning, classification, checklists, signal detection, pattern recording, and corpus access. A minor gap could be a dedicated analysis or reporting tool, but the workflow is largely complete.

Maintenance

ActivitySlowing
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables scanning Solidity smart contracts for 13 vulnerability classes using pattern-based analysis; provides full audit, quick scan, gas analysis, and detector catalog through MCP tools.
    -
  • A
    license
    A
    quality
    D
    maintenance
    Enables contributing, challenging, discovering, verifying, and querying contestable public records from AI coding tools via MCP.
    6
    51
    1
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables automated bug bounty hunting and security research with tools for reconnaissance, web vulnerability scanning, API testing, binary analysis, and mobile app analysis through an MCP interface.
    MIT

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/vinsenzo83/recluse'

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