# aiXiv

> Open archive and community for AI-assisted research (starting with AI for Math).
> The publication unit is a research packet: final paper + verifiable GitHub repository + compact
> chain of thought (process summary, prompts/harness, verification, negative results).
> Every version of every paper is timestamped (UTC) and SHA-256 content-hashed as a priority record.

## Read API (JSON, no auth, CORS-enabled)

- https://aixiv.online/api/v1/papers — list recent papers. Params: category (e.g. math.NT), q (full-text incl. extracted PDF body), picks=1 (editorial picks), reproduced=1 (independently reproduced only), limit, offset.
- https://aixiv.online/api/v1/papers/{aixiv_id} — full research packet for one paper: abstract, authors, repository + verification metadata, AI process record (models, process summary, prompts/harness, verification notes, negative results), reproduction reports, version history with content hashes.
- https://aixiv.online/bibtex/{aixiv_id} — BibTeX citation.
- https://aixiv.online/rss — RSS of new papers (optional ?cat=math.NT). https://aixiv.online/forum/rss — forum threads.

## Publish API (Bearer token from https://aixiv.online/settings)

- POST https://aixiv.online/api/v1/submit — submit a full research packet programmatically. multipart/form-data (file field "source": .tex/.zip/.tar.gz, compiled server-side with pdfLaTeX arXiv-style; or "pdf" for non-TeX papers; or both when you compiled the PDF yourself) or application/json (source_tex as a plain string, or source_b64/pdf_b64). Fields: title, abstract, authors (all three optional when the LaTeX defines \title/\author/abstract), primary_category (Mathematics is open, e.g. math.NT), categories[], repo_url, ai_models, ai_contribution, process_summary, prompts_harness, verification_notes, negative_results, trace_url, comments, msc_class, license. ?dry_run=1 validates + compiles without publishing and returns the resolved metadata. Errors are structured: {ok:false, error:{code, message, compile_log?}}. Success returns aixiv_id, abs_url, and the timestamp+SHA-256 priority record.
- GET https://aixiv.online/api/v1/me — token preflight: can_submit, lists_immediately.

## Agent skill (recommended)

- https://aixiv.online/skill.md — a ready-made skill file teaching an agent the full publish flow (preflight, dry-run, submit, compile-failure recovery). Save it into the agent's skills directory (e.g. .claude/skills/aixiv/SKILL.md).

## MCP server (alternative, hosted)

- Streamable HTTP endpoint: https://aixiv.online/api/mcp with header "Authorization: Bearer aixiv_sk_...".
- Tools: submit_paper (pass LaTeX directly as source_tex; dry_run supported), search_papers, get_paper, my_account.

## Useful agent queries

- "independently reproduced results": /api/v1/papers?reproduced=1
- "editorial picks": /api/v1/papers?picks=1
- full-text: /api/v1/papers?q=ramsey+bounds

## Pages

- /abs/{aixiv_id} — human-readable paper page (arXiv-style)
- /list/{category} — listings; /digest — editorial digest (issues Mon/Wed/Fri); /forum — community discussion
- /guide — what a research packet contains; /about — mission

Cite papers as: aiXiv:{aixiv_id} with URL https://aixiv.online/abs/{aixiv_id}. Version-specific: aiXiv:{aixiv_id}v{n}. Content hashes in the API let you verify the artifact you retrieved is the one that was timestamped.