vaglio-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| vaglio_searchA | Find works across the open bibliographic sources, with failover by role. Walks Crossref -> OpenAlex -> PubMed -> OpenAIRE until one answers. A source that is rate limited is skipped, not retried: the response reports which sources refused and why, so a thin result is visibly thin. Args: query: search terms. limit: max results (keep modest; the budget is shared across agents). prefer: force a source to the front, e.g. "pubmed" for biomedical work. |
| vaglio_readA | Retrieve and STORE the body of a work, so its depth becomes verifiable. Tries the native readers first (arXiv PDF, Europe PMC full-text XML), then
resolves the DOI through Unpaywall to a legal open-access copy. The stored
file is the proof: |
| vaglio_statusA | Show the shared request budget: which hosts are usable, which are cooling down. This is the fleet view. When a source shows |
| vaglio_sourcesA | Catalogue of sources and what each one is actually good for. Roles are not interchangeable: finders locate a DOI, the opener resolves it to a legal copy, readers give you the body. Picking by role is what makes failover work. |
| vaglio_appraiseB | Attach an evidence tier to a claim, under the discipline that guards it. Tier A requires at least the abstract to have been retrieved — asserting
RCT-strength from a title alone is rejected here rather than caught later.
Tier D is a RECORDED refusal: it demands |
| vaglio_inscribeA | Write the run into the ~/ricerche archive as a versioned, schema-valid record. Closes the loop the archive exists for: research that stays in a transcript
gets lost. Copies any stored full text into the record's Will REFUSE |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: vaglio_search finds works, vaglio_read retrieves full text, vaglio_status shows budget/blocked hosts, vaglio_sources catalogues sources, vaglio_appraise attaches evidence tiers, vaglio_inscribe archives runs. No ambiguity.
All tool names follow a consistent 'vaglio_<verb>' pattern with lowercase and underscores. Verbs are descriptive and match the action (search, read, status, sources, appraise, inscribe).
Six tools is well-scoped for the server's purpose of searching, reading, appraising, and archiving bibliographic works. Each tool earns its place without unnecessary overlap.
The tool set covers the full logical workflow: search, retrieve full text, check system status, list sources, appraise evidence, and archive results. No obvious gaps for the intended domain.