Skip to main content
Glama

resolve_paper

Read-only

Turn a DOI, URL, or title query into a normalized paper candidate with metadata for structured full-text retrieval.

Instructions

Resolve a DOI, URL, or title query into a normalized paper candidate.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
yearNo
queryNo
titleNo
authorsNo

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed1 schema field changedv6.0.1
    • changedOutput schema / (root)
      Previous value: -{
      -  "$defs": {
      -    "ResolvedCandidateOutput": {
      -      "properties": {
      -        "author_score": {
      -          "type": "number"
      -        },
      -        "authors": {
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        },
      -        "doi": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "journal_title": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "landing_page_url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "provider_hint": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "published": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "score": {
      -          "type": "number"
      -        },
      -        "title": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "title_score": {
      -          "type": "number"
      -        },
      -        "year_score": {
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "TraceEventOutput": {
      -      "properties": {
      -        "attempt": {
      -          "anyOf": [
      -            {
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "attempt_id": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "code": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "component": {
      -          "type": "string"
      -        },
      -        "duration_ms": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "error_category": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "finished_at": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "http_status": {
      -          "anyOf": [
      -            {
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "message": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "outcome": {
      -          "type": "string"
      -        },
      -        "parent_span_id": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "provider": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "retry_after_seconds": {
      -          "anyOf": [
      -            {
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "retryable": {
      -          "anyOf": [
      -            {
      -              "type": "boolean"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "route": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "span_id": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "stage": {
      -          "type": "string"
      -        },
      -        "started_at": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "target": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "target_sha256": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        }
      -      },
      -      "type": "object"
      -    }
      -  },
      -  "properties": {
      -    "candidates": {
      -      "anyOf": [
      -        {
      -          "items": {
      -            "$ref": "#/$defs/ResolvedCandidateOutput"
      -          },
      -          "type": "array"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "code": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "confidence": {
      -      "type": "number"
      -    },
      -    "details": {
      -      "additionalProperties": true,
      -      "type": "object"
      -    },
      -    "doi": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "error": {
      -      "anyOf": [
      -        {
      -          "additionalProperties": true,
      -          "type": "object"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "error_category": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "http_status": {
      -      "anyOf": [
      -        {
      -          "type": "integer"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "index": {
      -      "type": "integer"
      -    },
      -    "landing_url": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "missing_env": {
      -      "anyOf": [
      -        {
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "provider": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "provider_hint": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "provider_lane": {
      -      "type": "string"
      -    },
      -    "query": {
      -      "type": "string"
      -    },
      -    "query_kind": {
      -      "type": "string"
      -    },
      -    "reason": {
      -      "type": "string"
      -    },
      -    "retry_after_seconds": {
      -      "anyOf": [
      -        {
      -          "type": "integer"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "retryable": {
      -      "anyOf": [
      -        {
      -          "type": "boolean"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "route": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "schema_version": {
      -      "type": "integer"
      -    },
      -    "source_trail": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "stage": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "status": {
      -      "type": "string"
      -    },
      -    "title": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "trace": {
      -      "items": {
      -        "$ref": "#/$defs/TraceEventOutput"
      -      },
      -      "type": "array"
      -    },
      -    "warnings": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    }
      -  },
      -  "type": "object"
      -}New value: +null
  2. Changed3 schema fields changedv5.5.0
    • addedOutput schema / properties / error
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / index
      Added value: +{
      +  "type": "integer"
      +}
    • addedOutput schema / properties / provider_lane
      Added value: +{
      +  "type": "string"
      +}
  3. Changed57 schema fields changedv4.1.0
    • removedOutput schema / $defs / ResolvedCandidateOutput / properties / author_score / title
      Removed value: -"Author Score"
    • removedOutput schema / $defs / ResolvedCandidateOutput / properties / authors / title
      Removed value: -"Authors"
    • removedOutput schema / $defs / ResolvedCandidateOutput / properties / doi / title
      Removed value: -"Doi"
    • removedOutput schema / $defs / ResolvedCandidateOutput / properties / journal_title / title
      Removed value: -"Journal Title"
    • removedOutput schema / $defs / ResolvedCandidateOutput / properties / landing_page_url / title
      Removed value: -"Landing Page Url"
    • removedOutput schema / $defs / ResolvedCandidateOutput / properties / provider_hint / title
      Removed value: -"Provider Hint"
    • removedOutput schema / $defs / ResolvedCandidateOutput / properties / published / title
      Removed value: -"Published"
    • removedOutput schema / $defs / ResolvedCandidateOutput / properties / score / title
      Removed value: -"Score"
    • removedOutput schema / $defs / ResolvedCandidateOutput / properties / title / title
      Removed value: -"Title"
    • removedOutput schema / $defs / ResolvedCandidateOutput / properties / title_score / title
      Removed value: -"Title Score"
    • removedOutput schema / $defs / ResolvedCandidateOutput / properties / year_score / title
      Removed value: -"Year Score"
    • removedOutput schema / $defs / ResolvedCandidateOutput / title
      Removed value: -"ResolvedCandidateOutput"
    • addedOutput schema / $defs / TraceEventOutput
      Added value: +{
      +  "properties": {
      +    "attempt": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "attempt_id": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "code": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "component": {
      +      "type": "string"
      +    },
      +    "duration_ms": {
      +      "anyOf": [
      +        {
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "error_category": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "finished_at": {
      +      "anyOf": [
      +        {
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "http_status": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "message": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "outcome": {
      +      "type": "string"
      +    },
      +    "parent_span_id": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "provider": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "retry_after_seconds": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "retryable": {
      +      "anyOf": [
      +        {
      +          "type": "boolean"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "route": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "span_id": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "stage": {
      +      "type": "string"
      +    },
      +    "started_at": {
      +      "anyOf": [
      +        {
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "target": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "target_sha256": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
    • removedOutput schema / properties / candidates / default
      Removed value: -null
    • removedOutput schema / properties / candidates / title
      Removed value: -"Candidates"
    • removedOutput schema / properties / code / default
      Removed value: -null
    • removedOutput schema / properties / code / title
      Removed value: -"Code"
    • removedOutput schema / properties / confidence / default
      Removed value: -null
    • removedOutput schema / properties / confidence / title
      Removed value: -"Confidence"
    • addedOutput schema / properties / details
      Added value: +{
      +  "additionalProperties": true,
      +  "type": "object"
      +}
    • removedOutput schema / properties / doi / default
      Removed value: -null
    • removedOutput schema / properties / doi / title
      Removed value: -"Doi"
    • removedOutput schema / properties / error_category / default
      Removed value: -null
    • removedOutput schema / properties / error_category / title
      Removed value: -"Error Category"
    • removedOutput schema / properties / http_status / default
      Removed value: -null
    • removedOutput schema / properties / http_status / title
      Removed value: -"Http Status"
    • removedOutput schema / properties / landing_url / default
      Removed value: -null
    • removedOutput schema / properties / landing_url / title
      Removed value: -"Landing Url"
    • removedOutput schema / properties / missing_env / default
      Removed value: -null
    • removedOutput schema / properties / missing_env / title
      Removed value: -"Missing Env"
    • removedOutput schema / properties / provider / default
      Removed value: -null
    • removedOutput schema / properties / provider / title
      Removed value: -"Provider"
    • removedOutput schema / properties / provider_hint / default
      Removed value: -null
    • removedOutput schema / properties / provider_hint / title
      Removed value: -"Provider Hint"
    • removedOutput schema / properties / query / default
      Removed value: -null
    • removedOutput schema / properties / query / title
      Removed value: -"Query"
    • removedOutput schema / properties / query_kind / default
      Removed value: -null
    • removedOutput schema / properties / query_kind / title
      Removed value: -"Query Kind"
    • removedOutput schema / properties / reason / default
      Removed value: -null
    • removedOutput schema / properties / reason / title
      Removed value: -"Reason"
    • removedOutput schema / properties / retry_after_seconds / default
      Removed value: -null
    • removedOutput schema / properties / retry_after_seconds / title
      Removed value: -"Retry After Seconds"
    • addedOutput schema / properties / retryable
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / route
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • removedOutput schema / properties / schema_version / default
      Removed value: -null
    • removedOutput schema / properties / schema_version / title
      Removed value: -"Schema Version"
    • removedOutput schema / properties / source_trail / default
      Removed value: -null
    • removedOutput schema / properties / source_trail / title
      Removed value: -"Source Trail"
    • addedOutput schema / properties / stage
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • removedOutput schema / properties / status / default
      Removed value: -null
    • removedOutput schema / properties / status / title
      Removed value: -"Status"
    • removedOutput schema / properties / title / default
      Removed value: -null
    • removedOutput schema / properties / title / title
      Removed value: -"Title"
    • addedOutput schema / properties / trace
      Added value: +{
      +  "items": {
      +    "$ref": "#/$defs/TraceEventOutput"
      +  },
      +  "type": "array"
      +}
    • removedOutput schema / properties / warnings / default
      Removed value: -null
    • removedOutput schema / properties / warnings / title
      Removed value: -"Warnings"
    • removedOutput schema / title
      Removed value: -"ResolvePaperOutput"
  4. Addedv3.2.1
  5. Removedv3.1.3
  6. First observedv1.0.0

TDQS

A3.7/5.0
Behavior4/5

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

The annotations already provide readOnlyHint and openWorldHint, so the safety profile is covered. The description adds useful behavioral context by stating that the result is a 'candidate' that is 'normalized', implying the tool may not always return a definitive match and that output is standardized. No contradiction exists.

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 a single, concise sentence that front-loads the verb, the resource, the input forms, and the output form. Every word earns its place, with no filler or repetition of schema field names.

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?

With four optional parameters, no parameter descriptions, no output schema, and no usage guidance, this description is too thin to fully equip an agent. It does not state whether at least one parameter is required, what happens if multiple forms are provided, what a 'normalized paper candidate' contains, or how resolution failures should be handled.

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 0%, so the description carries the full burden for parameter semantics. It mentions 'DOI, URL, or title query' but does not map these onto the schema's query, title, authors, or year parameters. The authors and year fields are left entirely unexplained, and no guidance is given on how the parameters combine or which are mutually exclusive.

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 names a specific action ('Resolve'), a resource ('paper'), and the accepted inputs ('DOI, URL, or title query'), and clarifies the output ('normalized paper candidate'). This clearly distinguishes it from siblings like fetch_paper and batch_resolve, which involve retrieval and batching rather than resolution.

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?

Usage is implied by the purpose: use this tool when you need to turn an identifier or title into a normalized paper candidate. However, there is no explicit guidance about when to prefer this over fetch_paper, has_fulltext, or batch_resolve, nor any mention of exclusions or workflow sequencing.

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

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/Dictation354/paper-fetch-skill'

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