Sudoc SRU MCP demo

by geraldineco.huggingface.geraldine/sudoc-sru-mcp

  • Remote endpoint
  • 5 tools

Tools

  • sudoc_sru_mcp_count_records Count the Sudoc records matching an SRU query without fetching any of them. One HTTP call with maximumRecords=1. Use it to size a corpus before a large search_sudoc, or to check that a query matches anything before refining it. Same query syntax as search_sudoc — limitations such as tdo, lan or apu must be written into `query` yourself, e.g. "edi=gallimard and lan=fre". Returns: {"source": "sudoc-sru", "command": "count_records", "total_found": int, "returned": 0, "results": [], "query": str, "url_used": str, "error": str | null}
  • sudoc_sru_mcp_lookup_by_isbn Fetch the Sudoc records carrying a given ISBN. One ISBN can match several records. Hyphens are optional: "978-2-07-041311-9" and "9782070413119" behave the same. The Sudoc `isb` index covers monographs only; for serials, query the `isn` index through search_sudoc. Returns: {"source": "sudoc-sru", "command": "lookup_by_isbn", "total_found": int, "returned": int, "isbn_queried": str, "results": [<same record shape as search_sudoc>], "error": str | null}
  • sudoc_sru_mcp_lookup_by_ppn Fetch one Sudoc record by its PPN, the catalogue's unique record identifier. Returns: {"source": "sudoc-sru", "command": "lookup_by_ppn", "total_found": int, "returned": int, "results": [<same record shape as search_sudoc>], "error": str | null}
  • sudoc_sru_mcp_scan_index Browse a Sudoc index alphabetically from a starting term (SRU `scan` operation). Use it to discover the normalized form of a term before writing an exact query, to see its variants, to understand why a query returns nothing, or to read the record count behind each term. Indexes: mti aut per org msu vma fgr msa mee nth res lva fir rec rbc pcp rpc cot tou edi col tab tco sou. Returns: {"source": "sudoc-sru", "command": "scan_index", "total_found": int, "returned": int, "index": str, "start_term": str, "results": [{"term": str | null, "count": int | null}], "error": str | null}
  • sudoc_sru_mcp_search_sudoc Search the French union catalogue Sudoc over the Abes SRU service. Returns: {"source": "sudoc-sru", "command": "search_sudoc", "total_found": int, "returned": int, "query_used": str, "results": [{"source": "sudoc", "id": str, "url": str, "ppn": str, "title": str, "authors": [str], "year": int | null, "publisher": str | null, "sudoc_url": str}], "error": str | null}

As the server's own listing gives them. We never call a tool.