# Reported issues for arxiv-mcp-server by blazickjp

Pod holds 24 of 103 GitHub reports that passed its relevance review. This can include external user reports, maintainer-confirmed bugs, and concrete feature gaps. Treat them as evidence to inspect, not a count of distinct defects.

Back to [arxiv-mcp-server by blazickjp](/mcp/arxiv-mcp-server-by-blazickjp).

## Most discussed

### MCP error connection closed

I am using cherry studio as my MCP client, and when adding arxiv-mcp-server it shows the error below

![Image](https://github.com/user-attachments/assets/aa467756-a56c-42f6-bbf0-d8e9348ff9ee)

![Image](https://github.com/user-attachments/assets/eb4e18f9-cd01-4b07-a18f-bcdecc38100e)

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/20) · 2025-03-31 · closed · external user · 11 comments

### An executable named `arxiv-mcp-server` is not provided by package `arxiv-mcp-server`

I'm using cherry studio to use this mcp server, with config in README:

![Image](https://github.com/user-attachments/assets/825b9a1f-f2ee-4015-9a81-2e92da9b7167)

then i face error log below:
```
[2025-06-10 01:12:31.864] [info]  [MCP] Starting server with command: /Users/kevinello/.cherrystudio/bin/uv tool run arxiv-mcp-server --storage-path /Users/kevinello/Downloads/paper
[2025-06-10 01:12:31.881] [info]  [MCP] Stdio stderr for server: arxiv-mcp-server  warning: An executable named `arxiv-mcp

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/35) · 2025-06-09 · closed · external user · 10 comments

### Server disconnected error

My configuration is as follows:

System: macOS 15.3.2
Claude Desktop 0.8.1 (mac version)

I got other MCP servers running fine: 'brave-search', 'filesystem', etc.

I have followed  the 'npx' installation instructions:

`npx -y @smithery/cli install arxiv-mcp-server --client claude`

This automatically creates this entry in the `claude_desktop_config.json` file, similar to other MCP servers I use through npx:

```
    "arxiv-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
   

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/16) · 2025-03-22 · closed · external user · 8 comments

### chatwise mcp client doesn't work

The config I set in chatwise:

![Image](https://github.com/user-attachments/assets/aba7befa-5734-4460-a39a-88c0285130bd)

How should I solve this?

Thanks in advance.

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/25) · 2025-04-09 · closed · external user · 7 comments

### response": {     "content": [       {         "type": "text",         "text": "{\"status\": \"error\", \"message\": \"Error reading paper: 'gbk' codec can't decode byte 0x94 in position 874: illegal multibyte sequence\"}"

这是什么问题

![Image](https://github.com/user-attachments/assets/55a94b2b-025c-4884-b080-b9298073e1a8)

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/17) · 2025-03-23 · closed · external user · 6 comments

### Claude for Desktop fails to load arxiv-mcp-server

I installed it using smithery:
`npx -y @smithery/cli install arxiv-mcp-server --client claude`

When Claude launched again I had the read error warning in the top right.

arxiv-mcp-server is added added last in my list of servers in my Claude settings json:

```
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "run",
                "arxiv-mcp-server",
                "--storage-path",
                "~/.arxiv-mcp-server/papers"
   

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/7) · 2025-01-04 · closed · external user · 6 comments

### Asynchronous Download and Conversion Creates Workflow Challenges for Sequential Processing

__Description:__

The current design of `download_paper` and `read_paper` tools involves asynchronous conversion, which makes sequential workflows difficult for LLMs and automated systems.

__Problem:__

- `download_paper` initiates download and starts asynchronous conversion.
- `read_paper` can only access the paper after conversion completes.
- Conversion time is unpredictable and may take variable duration.
- LLMs operate in linear, sequential steps and cannot easily "wait and come back later

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/54) · 2025-12-15 · closed · external user · 5 comments

### I have encountered some issues

i hace used uv to install this MCP,but when i  configuration cline, I have encountered some issues

![Image](https://github.com/user-attachments/assets/255e04c2-94d7-4030-883c-18461325c5e6)

![Image](https://github.com/user-attachments/assets/dddb7533-6e16-4345-8837-4c9e71d9f8a6)

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/27) · 2025-04-15 · closed · external user · 5 comments

## Most recent

### HTML→markdown: Switch Transformers extraction noise (dup author, split citations/figures)

## Context
Post-#238–#245 dogfood. P2 / nice-to-have. Related to title fix (# decorative letter-split) if same extractor; distinct from #239 front-matter focus.

## Problem
On Switch Transformers `2101.03961` (HTML path), extraction leaves noisy markdown:
- Duplicated author line.
- Citations split across lines, e.g. `[\n1\n]`.
- Figure refs split, e.g. `Fig.\n2\n`.

## Repro
1. `download_paper(paper_id="2101.03961")`.
2. `read_paper(paper_id="2101.03961", start=0, max_chars=4000)` (and skim cit

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/260) · 2026-08-23 · closed · 0 comments

### export_citations: exact-duplicate paper_ids emit identical BibTeX twice

## Context
Post-#238–#245 dogfood. P2. Related but distinct from #241 / #247 (bare + versioned sibling collapse still works).

## Problem
Passing the same id twice emits two identical BibTeX entries. Exact-duplicate collapse is missing even though bare+versioned sibling dedupe (#241) already landed.

## Repro
```
export_citations(paper_ids=["1706.03762", "1706.03762"])
```
Also: `["1706.03762v7", "1706.03762v7"]`.

Observed: two identical `@misc` / BibTeX blocks for the same paper.

Confirm stil

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/259) · 2026-08-23 · closed · 0 comments

### get_paper_outline: numbered body lists become fake L1 sections (Switch Transformers)

## Context
Post-#238–#245 dogfood. P1. Related but distinct from #240 (wrong order / duplicate Method) and #229/#235 (References cutoff / heading heuristics).

## Problem
For Switch Transformers (`2101.03961`) via HTML, `get_paper_outline` promotes numbered Future Work list items (`4.`, `5.`, …) into fake L1 sections. Numbered body lists must not become outline sections.

## Repro
1. `download_paper(paper_id="2101.03961")` (HTML path).
2. `get_paper_outline(paper_id="2101.03961")`.
3. Inspect se

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/257) · 2026-08-23 · closed · 0 comments

### get_paper_latex / get_paper_latex_section: return_full_text missing from inputSchema

## Context
Post-#238–#245 dogfood. P1. Parity with `download_paper` / `read_paper` schemas that already expose `return_full_text`.

## Problem
`get_paper_latex` and `get_paper_latex_section` handlers honor `return_full_text=true`, and `next_retrieval` guidance tells callers to pass it — but the tools’ `inputSchema` only lists `paper_id` / `start` / `max_chars` (and section args where applicable) with `additionalProperties: false`. Strict MCP clients therefore cannot send the parameter the handle

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/256) · 2026-08-23 · closed · 0 comments

### check_alerts: arXiv 429 returns bare Error text, not JSON rate_limited

## Context
Post-#238–#245 dogfood. P1. Related: #238 (`search_papers` 429 → JSON via `_rate_limited_response`); `citation_graph` soft rate-limit UX.

## Problem
Under arXiv IP throttle, `check_alerts` returns bare text:

```
Error: arXiv is rate limiting...
```

`handle_search` maps the same condition through `_rate_limited_response` to structured JSON with `status=rate_limited`. `handle_check_alerts` only has a broad `except Exception: Error: {exc}` path, so agents get an unstructured stall-lik

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/255) · 2026-08-23 · closed · 0 comments

### download_paper: legacy arXiv IDs crash FileNotFoundError (parent dir not created)

## Context
Post-#238–#245 dogfood. P0.

## Problem
`download_paper` on legacy slash-form arXiv IDs (e.g. `hep-th/9901001`) fetches HTML successfully, then crashes with `FileNotFoundError` when writing `papers/<cat>/<id>.md` because the parent directory is never created.

`get_paper_path` only `mkdir`s `STORAGE_PATH`; `bare_arxiv_id` keeps the slash, so the write path includes an uncreated category subdirectory. The error also leaks absolute filesystem paths to the client.

Also reproduces on `qu

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/254) · 2026-08-23 · closed · 0 comments

### docs: watch_topic omit-categories preserves; use categories:[] to clear

## Context
Post-v0.7.1 deep dogfood. Behavior fixed in #222 (`watch_topic` update no longer drops categories when omitted).

## Problem
Docs / tool description may still leave agents unsure how to clear vs preserve categories on update.

Verified behavior in dogfood:
- Omitting `categories` on `watch_topic` **preserves** existing categories.
- Passing `categories: []` **clears** categories.

## Expected (docs-only)
Document clearly (README and/or tool description):
- Omit `categories` → preserve

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/245) · 2026-08-23 · closed · 0 comments

### content_warning: short first-chunk field; no long banner on later chunks

## Context
Post-v0.7.1 deep dogfood. Align with closed work:
- #215 — do not re-prepend UNTRUSTED warning on every paginated chunk
- #230 — shorten token-heavy content_warning / EXTERNAL CONTENT prefixes

## Problem
Residual consistency gaps on `read_paper` / `download_paper` pagination:
- Some first-chunk success paths may still omit the short `content_warning` field.
- Later chunks must never re-embed a long UNTRUSTED banner into `content` (or repeat a heavy warning).

Dogfood on ExpertFlow HT

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/244) · 2026-08-23 · closed · 0 comments

### read_paper: clearer error when requested version is not cached

## Context
Post-v0.7.1 deep dogfood. Related (closed, different angle): #202 (versioned vs bare cache keys).

## Problem
After downloading bare and/or `v2`, requesting a different version via `read_paper` returns a generic not-found with no hint about what *is* cached.

## Repro
1. `download_paper(paper_id=\"2410.17954\")` and/or `download_paper(paper_id=\"2410.17954v2\")`.
2. `read_paper(paper_id=\"2410.17954v1\", max_chars=1000)`.

Observed:
```json
{\"status\": \"error\", \"message\": \"Paper

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/243) · 2026-08-23 · closed · 0 comments

### search_papers: reject invalid sort_by values

## Context
Post-v0.7.1 deep dogfood.

## Problem
Unknown `sort_by` values (e.g. `notarealsort`) are silently accepted; the search still returns papers with no error or warning.

## Repro
```
search_papers(query=\"MoE\", max_results=1, sort_by=\"notarealsort\")
```
Observed: `ok` success payload with papers; invalid sort is ignored/silently coerced.

## Expected
- Reject unknown `sort_by` with a clear structured error (`status: error`, message naming the invalid value and listing allowed values).

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/242) · 2026-08-23 · closed · 0 comments

### export_citations: dedupe bare + versioned IDs of same paper

## Context
Post-v0.7.1 deep dogfood. Related (closed, different bug): #212 (false not-found when batching versions).

## Problem
Passing both a bare id and a versioned id for the same paper emits two BibTeX entries (`he2024expertflow` and `he2024expertflowa`) instead of one.

## Repro
```
export_citations(paper_ids=[\"2410.17954\", \"2410.17954v2\"])
```
(or the reverse order `[\"2410.17954v2\", \"2410.17954\"]`)

Observed: two `@misc` entries for ExpertFlow — keys `he2024expertflow` and `he2024

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/241) · 2026-08-23 · closed · 0 comments

### get_paper_outline (HTML): wrong order and duplicate Method headings

## Context
Post-v0.7.1 deep dogfood. Related: #209 (HTML outline was synthetic/ATX-only). LaTeX outline for the same paper is fine — this is HTML heading heuristics.

## Problem
For DAOP (`2501.10375`) downloaded via HTML, `get_paper_outline` returns sections in the wrong order and duplicates Method.

Observed HTML outline (abbreviated):
1. Abstract
2. Introduction
3. Preliminaries
4. Related Work
5. **Result**  ← appears before Method
6. Experimental Setup
7. **Method**
8. **Method**  ← duplica

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/240) · 2026-08-23 · closed · 0 comments

### HTML→markdown: clean author/CCS front-matter and \\times noise

## Context
Post-v0.7.1 deep dogfood. Related prior work: #158 (HTML chrome / duplicated math). Tool description claims clean extraction; HTML path on `download_paper` / `read_paper` still is not.

## Problem
HTML→markdown extraction leaves broken per-token author/CCS lines, `\\times` noise, and front-matter garbage (conference chrome, DOI/ISBN/CCS blocks, affiliation superscripts). Highest-impact cleanup first: author line + CCS/front-matter.

## Repro
1. `download_paper(paper_id=\"2410.17954\")

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/239) · 2026-08-23 · closed · 0 comments

### search_papers: retry/backoff on arXiv 429 with JSON error shape

## Context
Post-v0.7.1 deep dogfood. Related soft-handling precedent: `citation_graph` 429 path (#226 / #160).

## Problem
When arXiv returns HTTP 429, `search_papers` surfaces a bare text error and does not retry/backoff. Agents see a stall-like failure instead of a structured, actionable response.

Observed shape (dogfood):
```json
{"_raw": "Error: arXiv is rate limiting this IP (HTTP 429). Please wait 60 seconds before retrying."}
```

Empty / invalid search criteria similarly leak bare `Erro

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/238) · 2026-08-23 · closed · 0 comments

### content_warning / EXTERNAL CONTENT prefixes still token-heavy

## Priority
P2

## Problem
`content_warning` / EXTERNAL CONTENT prefixes are still token-heavy on abstracts/sections. Safety-good; consider shorter warning or once-per-session hint.

## Context
Filed from v0.7.0 post-release researcher dogfood. Related to #215 (warning moved off paginated content). Backlog only.

## Fix direction
- Shorter warning text, and/or
- Once-per-session / once-per-paper hint instead of repeating on every abstract/section tool

## Acceptance
- [ ] Token cost of warnings 

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/230) · 2026-08-22 · closed · 0 comments

### get_paper_outline ref pollution / flat methods

## Priority
P2

## Problem
On ExpertFlow (`2410.17954`):
- Method not split into 3.1/3.2
- Bogus tail sections like “USENIX ATC 23/21” from references

## Fix direction
- Stop outline at References/Bibliography
- Tighten bare-heading heuristics

## Context
Filed from v0.7.0 post-release researcher dogfood. Backlog only. Related to #209 bare HTML heading parse.

## Acceptance
- [ ] Outline does not invent sections from reference lines
- [ ] Numbered subsections appear when present in source
- [ ]

[Read the thread](https://github.com/blazickjp/arxiv-mcp-server/issues/229) · 2026-08-22 · closed · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/blazickjp/arxiv-mcp-server/issues).