arxiv-mcp.mtree.workers.dev

{
  "input": {
    "bodyFields": {
      "authors": {
        "description": "Comma-separated author names — matched as OR across authors. Optional.",
        "example": "Yoshua Bengio,Yann LeCun",
        "type": "string"
      },
      "categories": {
        "description": "Comma-separated arXiv category codes (e.g. \"cs.CL,cs.LG,stat.ML\") — matched as OR. Optional.",
        "example": "cs.CL,cs.LG",
        "type": "string"
      },
      "endDate": {
        "description": "Submitted-date end YYYY-MM-DD",
        "example": "2024-12-31",
        "type": "string"
      },
      "fromDays": {
        "description": "Look back this many days on submittedDate (1–3650)",
        "example": 365,
        "type": "number"
      },
      "limit": {
        "description": "Max results (1–50)",
        "example": 25,
        "type": "number"
      },
      "query": {
        "description": "Free-text query — searches title + abstract + authors. Optional if title/authors/categories supplied.",
        "example": "transformer architecture attention mechanism",
        "type": "string"
      },
      "sortBy": {
        "description": "relevance | lastUpdatedDate | submittedDate (default relevance)",
        "example": "submittedDate",
        "type": "string"
      },
      "sortOrder": {
        "description": "ascending | descending (default descending)",
        "example": "descending",
        "type": "string"
      },
      "startDate": {
        "description": "Submitted-date start YYYY-MM-DD (overrides fromDays)",
        "example": "2024-01-01",
        "type": "string"
      },
      "title": {
        "description": "Restrict to title matches (combined with `query` via AND). Optional.",
        "example": "retrieval augmented generation",
        "type": "string"
      }
    },
    "bodyType": "json",
    "discoverable": true,
    "method": "POST",
    "type": "http"
  },
  "output": {
    "example": {
      "results": [
        {
          "abs_url": "http://arxiv.org/abs/2401.12345v1",
          "authors": [
            "Ada Lovelace",
            "Alan Turing"
          ],
          "categories": [
            "cs.CL",
            "cs.LG"
          ],
          "id": "2401.12345",
          "pdf_url": "http://arxiv.org/pdf/2401.12345v1",
          "primary_category": "cs.CL",
          "published": "2024-01-23T18:00:00Z",
          "summary": "We revisit the transformer architecture …",
          "title": "Example: Attention is all you need (revisited)"
        }
      ],
      "source": "export.arxiv.org/api",
      "total_results": 12483
    }
  }
}