get_library_papers

Retrieve all papers from a NASA ADS library to access paper details in a specific collection. Use library ID to fetch complete bibliographic information.

Instructions

Get all papers from a specific library. Returns paper details for papers in the specified collection.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`library_id`	Yes	Library ID (from list_libraries)

Implementation Reference

src/nasa_ads_mcp/server.py:689-735 (handler)

The handler function that retrieves papers from a specific NASA ADS library by ID, fetches the bibcodes via API, queries paper details using ads.SearchQuery, and formats a list of papers with titles, authors, years, citations, and bibcodes.

async def get_library_papers(library_id: str) -> list[TextContent]:
    """Get papers from a library."""
    try:
        response = requests.get(
            f"{ADS_API_BASE}/biblib/libraries/{library_id}",
            headers=HEADERS,
            timeout=30
        )
        response.raise_for_status()
        
        data = response.json()
        bibcodes = data.get("documents", [])
        
        if not bibcodes:
            return [TextContent(
                type="text",
                text=f"No papers in library {library_id}"
            )]
        
        # Get paper details
        papers = ads.SearchQuery(
            q=f"bibcode:({' OR '.join(bibcodes)})",
            fl=["bibcode", "title", "author", "year", "citation_count"],
            rows=len(bibcodes)
        )
        
        paper_lines = [f"Papers in library {data.get('name', library_id)}:\n"]
        for i, paper in enumerate(papers, 1):
            authors = paper.author[:2] if paper.author else ["Unknown"]
            author_str = ", ".join(authors)
            if paper.author and len(paper.author) > 2:
                author_str += " et al."
            
            paper_lines.append(
                f"{i}. {paper.title[0] if paper.title else 'No title'}\n"
                f"   {author_str} ({paper.year}) | Citations: {paper.citation_count or 0}\n"
                f"   Bibcode: {paper.bibcode}\n"
            )
        
        return [TextContent(type="text", text="\n".join(paper_lines))]
    
    except Exception as e:
        logger.error(f"Error getting library papers: {e}")
        return [TextContent(
            type="text",
            text=f"Error getting library papers: {str(e)}"
        )]

src/nasa_ads_mcp/server.py:193-209 (registration)

The tool registration in the list_tools() function, defining the name, description, and input schema for get_library_papers.

Tool(
    name="get_library_papers",
    description=(
        "Get all papers from a specific library. "
        "Returns paper details for papers in the specified collection."
    ),
    inputSchema={
        "type": "object",
        "properties": {
            "library_id": {
                "type": "string",
                "description": "Library ID (from list_libraries)",
            },
        },
        "required": ["library_id"],
    },
),

src/nasa_ads_mcp/server.py:297-298 (registration)
The dispatch logic in the call_tool() function that routes calls to the get_library_papers handler.
```
elif name == "get_library_papers":
    return await get_library_papers(library_id=arguments["library_id"])
```

src/nasa_ads_mcp/server.py:199-208 (schema)

The input schema defining the required 'library_id' parameter as a string.

inputSchema={
    "type": "object",
    "properties": {
        "library_id": {
            "type": "string",
            "description": "Library ID (from list_libraries)",
        },
    },
    "required": ["library_id"],
},

NASA ADS MCP Server