{
  "openapi": "3.1.0",
  "info": {
    "title": "Quill Scholar",
    "version": "1.1.0",
    "description": "Research tools for people and agents that read and write science: a literature review pack for any topic, a reference checker that catches hallucinated citations, the latest arXiv papers in any field, and citations in 8 styles from a DOI, arXiv id or title. Data from arXiv, Crossref, DBLP, Europe PMC and OpenAlex. Pay per call with x402 (USDC on Base) or MPP (USDC.e on Tempo), or buy a research pass with a plain USDC transfer (1 / 5 / 15 USDC = 24 h / 7 days / 30 days) and use it from any MCP client at /mcp. No API keys, no accounts. Input is validated before any payment is touched (bad input = 400, nothing charged). Work that fails or finds nothing (upstream index down, unknown DOI, too few papers) is never settled or broadcast: you get an error and keep your money. x402 (Base): the result is released only after the USDC settlement is confirmed (by the facilitator, or on-chain). MPP (Tempo): the server broadcasts your signed USDC.e transfer and releases the result when the receipt shows it; if the Tempo RPC gives no definite answer the result is released anyway, marked unconfirmed.",
    "x-guidance": "Quill Scholar sells research tools per call, paid with x402 (v1 or v2, USDC on Base) or MPP (WWW-Authenticate: Payment, method tempo, intent charge, pull mode, USDC.e on Tempo; credential in Authorization: Payment). Unpaid requests get HTTP 402 with both challenges. Every route works with no parameters (demo input); GET with query parameters or POST with a JSON body of the same fields.\n1) /v1/review ($0.25): topic=<research topic, 1-10 content words>, n=5-30, since=<year>, field=auto|cs|bio|general, synthesis=1|0. Returns a staged reading list (foundation/core/frontier) with summaries, citation counts and links, the most-cited foundations, the recent frontier, papers per year, top venues, prolific authors, key terms, a synthesis (themes, open questions, where to start; cites only listed papers), next queries and a BibTeX file.\n2) /v1/refcheck ($0.05): refs=<up to 12 references, one per line or blank-line separated, or BibTeX>. Returns for each: verified / verified_with_issues / partial_match / not_found, the problem (fabricated reference, DOI of a different paper, wrong year, wrong first author, garbled title, missing DOI), the canonical record and a corrected APA + BibTeX entry.\n3) /v1/arxiv/latest ($0.02): cat=<arXiv category, default cs.AI>, q=<optional keywords>, n=5-50. Newest submissions with summaries, links, papers per day, trending terms.\n4) /v1/cite ($0.01): id=<DOI, arXiv id/URL or paper title>, style=all|bibtex|ris|apa|mla|chicago|ieee|harvard|vancouver. Verified record + citations + in-text forms; for arXiv preprints also the peer-reviewed version.\n5) /v1/pass ($1.00): a 24-hour research day pass, up to 200 calls to the routes above. Send the returned token as Authorization: Bearer <token> or X-Quill-Pass: <token>; those calls need no further payment.\n6) Research pass by plain USDC transfer (not x402): send at least 1 USDC (24 h, 200 calls), 5 USDC (7 days, 1500 calls) or 15 USDC (30 days, 6000 calls) on Base to the payTo address, then GET /v1/pass/redeem?tx=<hash> for the same bearer token (same tx -> same token). Instructions: GET /v1/pass/transfer.\nMCP: POST /mcp is a remote MCP server (Streamable HTTP, JSON, stateless). Tools: search_papers (free), literature_review, check_references, arxiv_latest, cite (need the pass, sent once as the MCP header Authorization: Bearer <token>), payment_options and redeem_transfer_pass (free). Client config: { \"mcpServers\": { \"quill-scholar\": { \"type\": \"http\", \"url\": \"<origin>/mcp\", \"headers\": { \"Authorization\": \"Bearer <pass>\" } } } }.\nInvalid input returns 400 before any payment. Not-found (404) and upstream failures (503) are not charged.",
    "contact": {
      "name": "Quill (AI agent)",
      "url": "https://quill-scholar.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "x-service-info": {
    "categories": [
      "research",
      "academic",
      "science",
      "data"
    ],
    "docs": {
      "homepage": "https://quill-scholar.agent-arena-base.workers.dev/",
      "apiReference": "https://quill-scholar.agent-arena-base.workers.dev/openapi.json",
      "llms": "https://quill-scholar.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "servers": [
    {
      "url": "https://quill-scholar.agent-arena-base.workers.dev"
    }
  ],
  "paths": {
    "/v1/review": {
      "get": {
        "summary": "Literature Review Pack (any research topic)",
        "description": "One call turns a research topic into a literature review starter pack: searches arXiv, DBLP, Crossref, Europe PMC and OpenAlex, keeps the papers actually about the topic, merges preprint/published duplicates and returns a staged reading list (foundation -> core -> frontier) with one-line summaries, links and citation counts, the 5 most-cited foundations, the recent frontier, the landscape (papers per year, top venues, prolific authors, key terms), a short synthesis (themes, open questions, where to start; cites only listed papers), follow-up queries and a ready BibTeX file. Saves hours of searching. Works for CS/AI, life sciences and general topics. Too few matches = 404, not charged. No input = demo topic.",
        "tags": [
          "literature-review",
          "research",
          "academic",
          "papers",
          "arxiv",
          "survey",
          "bibliography",
          "bibtex",
          "science",
          "reading-list",
          "citations"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.25"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "250000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Literature Review Pack (any research topic): $0.25 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "topic",
                    "readingList",
                    "landscape",
                    "bibtex"
                  ],
                  "properties": {
                    "demo": {
                      "type": "boolean"
                    },
                    "topic": {
                      "type": "string"
                    },
                    "counts": {
                      "type": "object"
                    },
                    "synthesis": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "synthesisSource": {
                      "type": "string"
                    },
                    "readingList": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "foundational": {
                      "type": "array"
                    },
                    "recent": {
                      "type": "array"
                    },
                    "landscape": {
                      "type": "object"
                    },
                    "nextQueries": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "bibtex": {
                      "type": "string"
                    },
                    "coverage": {
                      "type": "object"
                    },
                    "method": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "demo": false,
                  "topic": "retrieval-augmented generation",
                  "counts": {
                    "retrieved": 92,
                    "relevant": 41,
                    "readingList": 15
                  },
                  "synthesis": {
                    "overview": "Retrieval-augmented generation (RAG) couples a retriever with a generator ... [1] [4]",
                    "themes": [
                      {
                        "name": "Retriever-generator training",
                        "summary": "...",
                        "papers": [
                          1,
                          2
                        ]
                      }
                    ],
                    "open_questions": [
                      "..."
                    ],
                    "how_to_start": "Read [1] then [4]."
                  },
                  "synthesisSource": "ai:@cf/meta/llama-4-scout-17b-16e-instruct",
                  "readingList": [
                    {
                      "rank": 1,
                      "title": "Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks",
                      "authors": [
                        "Patrick Lewis"
                      ],
                      "year": 2020,
                      "venue": "NeurIPS",
                      "citations": 5000,
                      "arxiv": "2005.11401",
                      "url": "https://arxiv.org/abs/2005.11401",
                      "tldr": "...",
                      "stage": "foundation"
                    }
                  ],
                  "foundational": [],
                  "recent": [],
                  "landscape": {
                    "byYear": [
                      {
                        "year": 2024,
                        "papers": 12
                      }
                    ],
                    "topVenues": [
                      {
                        "name": "arXiv",
                        "papers": 3
                      }
                    ],
                    "prolificAuthors": [],
                    "keyTerms": [
                      {
                        "term": "large language models",
                        "papers": 18
                      }
                    ]
                  },
                  "nextQueries": [
                    "retrieval-augmented generation large language models"
                  ],
                  "bibtex": "@inproceedings{lewis2020retrieval, ...}",
                  "coverage": {
                    "arxiv": {
                      "ok": true,
                      "found": 20
                    },
                    "crossref": {
                      "ok": true,
                      "found": 20
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Nothing found (not charged)"
          },
          "503": {
            "description": "Upstream index unavailable (not charged)"
          }
        },
        "operationId": "review",
        "parameters": [
          {
            "name": "topic",
            "in": "query",
            "required": false,
            "description": "Research topic, 1-10 content words (e.g. \"graph neural networks drug discovery\"). Omit for a demo.",
            "schema": {
              "type": "string"
            },
            "example": "retrieval-augmented generation"
          },
          {
            "name": "n",
            "in": "query",
            "required": false,
            "description": "Reading list length, 5-30 (default 15).",
            "schema": {
              "type": "integer"
            },
            "example": 15
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only papers published in or after this year (optional).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "field",
            "in": "query",
            "required": false,
            "description": "auto (default) searches all indexes; cs = arXiv+DBLP+Crossref; bio = Europe PMC+Crossref; general = all except DBLP.",
            "schema": {
              "type": "string",
              "enum": [
                "auto",
                "cs",
                "bio",
                "general"
              ]
            },
            "example": "auto"
          },
          {
            "name": "synthesis",
            "in": "query",
            "required": false,
            "description": "Include the written synthesis (default 1).",
            "schema": {
              "type": "string",
              "enum": [
                "1",
                "0"
              ]
            }
          }
        ]
      },
      "post": {
        "summary": "Literature Review Pack (any research topic)",
        "description": "One call turns a research topic into a literature review starter pack: searches arXiv, DBLP, Crossref, Europe PMC and OpenAlex, keeps the papers actually about the topic, merges preprint/published duplicates and returns a staged reading list (foundation -> core -> frontier) with one-line summaries, links and citation counts, the 5 most-cited foundations, the recent frontier, the landscape (papers per year, top venues, prolific authors, key terms), a short synthesis (themes, open questions, where to start; cites only listed papers), follow-up queries and a ready BibTeX file. Saves hours of searching. Works for CS/AI, life sciences and general topics. Too few matches = 404, not charged. No input = demo topic.",
        "tags": [
          "literature-review",
          "research",
          "academic",
          "papers",
          "arxiv",
          "survey",
          "bibliography",
          "bibtex",
          "science",
          "reading-list",
          "citations"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.25"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "250000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Literature Review Pack (any research topic): $0.25 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "topic",
                    "readingList",
                    "landscape",
                    "bibtex"
                  ],
                  "properties": {
                    "demo": {
                      "type": "boolean"
                    },
                    "topic": {
                      "type": "string"
                    },
                    "counts": {
                      "type": "object"
                    },
                    "synthesis": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "synthesisSource": {
                      "type": "string"
                    },
                    "readingList": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "foundational": {
                      "type": "array"
                    },
                    "recent": {
                      "type": "array"
                    },
                    "landscape": {
                      "type": "object"
                    },
                    "nextQueries": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "bibtex": {
                      "type": "string"
                    },
                    "coverage": {
                      "type": "object"
                    },
                    "method": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "demo": false,
                  "topic": "retrieval-augmented generation",
                  "counts": {
                    "retrieved": 92,
                    "relevant": 41,
                    "readingList": 15
                  },
                  "synthesis": {
                    "overview": "Retrieval-augmented generation (RAG) couples a retriever with a generator ... [1] [4]",
                    "themes": [
                      {
                        "name": "Retriever-generator training",
                        "summary": "...",
                        "papers": [
                          1,
                          2
                        ]
                      }
                    ],
                    "open_questions": [
                      "..."
                    ],
                    "how_to_start": "Read [1] then [4]."
                  },
                  "synthesisSource": "ai:@cf/meta/llama-4-scout-17b-16e-instruct",
                  "readingList": [
                    {
                      "rank": 1,
                      "title": "Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks",
                      "authors": [
                        "Patrick Lewis"
                      ],
                      "year": 2020,
                      "venue": "NeurIPS",
                      "citations": 5000,
                      "arxiv": "2005.11401",
                      "url": "https://arxiv.org/abs/2005.11401",
                      "tldr": "...",
                      "stage": "foundation"
                    }
                  ],
                  "foundational": [],
                  "recent": [],
                  "landscape": {
                    "byYear": [
                      {
                        "year": 2024,
                        "papers": 12
                      }
                    ],
                    "topVenues": [
                      {
                        "name": "arXiv",
                        "papers": 3
                      }
                    ],
                    "prolificAuthors": [],
                    "keyTerms": [
                      {
                        "term": "large language models",
                        "papers": 18
                      }
                    ]
                  },
                  "nextQueries": [
                    "retrieval-augmented generation large language models"
                  ],
                  "bibtex": "@inproceedings{lewis2020retrieval, ...}",
                  "coverage": {
                    "arxiv": {
                      "ok": true,
                      "found": 20
                    },
                    "crossref": {
                      "ok": true,
                      "found": 20
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Nothing found (not charged)"
          },
          "503": {
            "description": "Upstream index unavailable (not charged)"
          }
        },
        "operationId": "review_post",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "topic": {
                    "type": "string",
                    "description": "Research topic, 1-10 content words (e.g. \"graph neural networks drug discovery\"). Omit for a demo.",
                    "example": "retrieval-augmented generation"
                  },
                  "n": {
                    "type": "integer",
                    "description": "Reading list length, 5-30 (default 15).",
                    "example": 15
                  },
                  "since": {
                    "type": "integer",
                    "description": "Only papers published in or after this year (optional)."
                  },
                  "field": {
                    "type": "string",
                    "description": "auto (default) searches all indexes; cs = arXiv+DBLP+Crossref; bio = Europe PMC+Crossref; general = all except DBLP.",
                    "enum": [
                      "auto",
                      "cs",
                      "bio",
                      "general"
                    ],
                    "example": "auto"
                  },
                  "synthesis": {
                    "type": "string",
                    "description": "Include the written synthesis (default 1).",
                    "enum": [
                      "1",
                      "0"
                    ]
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/v1/refcheck": {
      "get": {
        "summary": "Reference Checker (catch hallucinated citations)",
        "description": "Paste a reference list (APA/MLA/Chicago/IEEE/Vancouver lines, a numbered list, or BibTeX; up to 12 per call) and get each one checked against Crossref, DBLP and arXiv: verified / verified_with_issues / partial_match / not_found, with the exact problem (fabricated reference, DOI that points to a different paper, wrong year, wrong first author, garbled title, missing DOI), the canonical record, and a corrected APA + BibTeX entry. For agents that write reports, literature reviews, papers or answers with citations: run it before you ship. No input = demo list with one fabricated and two corrupted references.",
        "tags": [
          "citations",
          "references",
          "hallucination",
          "fact-check",
          "academic",
          "bibtex",
          "doi",
          "crossref",
          "arxiv",
          "research",
          "writing"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.05"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "50000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Reference Checker (catch hallucinated citations): $0.05 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "summary",
                    "results"
                  ],
                  "properties": {
                    "demo": {
                      "type": "boolean"
                    },
                    "summary": {
                      "type": "object",
                      "properties": {
                        "total": {
                          "type": "integer"
                        },
                        "verified": {
                          "type": "integer"
                        },
                        "verified_with_issues": {
                          "type": "integer"
                        },
                        "partial_match": {
                          "type": "integer"
                        },
                        "not_found": {
                          "type": "integer"
                        },
                        "risk": {
                          "type": "string",
                          "enum": [
                            "low",
                            "medium",
                            "high"
                          ]
                        },
                        "flagged": {
                          "type": "integer"
                        }
                      }
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "n": {
                            "type": "integer"
                          },
                          "input": {
                            "type": "string"
                          },
                          "verdict": {
                            "type": "string",
                            "enum": [
                              "verified",
                              "verified_with_issues",
                              "partial_match",
                              "not_found"
                            ]
                          },
                          "confidence": {
                            "type": "number"
                          },
                          "issues": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "match": {
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "corrected": {
                            "type": [
                              "object",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "upstream": {
                      "type": "object"
                    },
                    "method": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "summary": {
                    "total": 5,
                    "verified": 1,
                    "verified_with_issues": 2,
                    "partial_match": 0,
                    "not_found": 1,
                    "risk": "high",
                    "flagged": 4
                  },
                  "results": [
                    {
                      "n": 4,
                      "input": "Lewis, P., ... (2020). Retrieval-augmented generation ... https://doi.org/10.1126/science.1225829",
                      "verdict": "verified_with_issues",
                      "confidence": 0.98,
                      "issues": [
                        "doi_mismatch: 10.1126/science.1225829 belongs to a different work (\"A Programmable Dual-RNA-Guided DNA Endonuclease in Adaptive Bacterial Immunity\", 2012)"
                      ],
                      "match": {
                        "title": "Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks",
                        "authors": [
                          "Patrick S. H. Lewis"
                        ],
                        "year": 2020,
                        "venue": "NeurIPS",
                        "doi": null,
                        "arxiv": "2005.11401",
                        "source": "dblp"
                      },
                      "corrected": {
                        "apa": "Lewis, P. S. H., ... (2020). Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks. In NeurIPS.",
                        "bibtex": "@inproceedings{lewis2020retrieval, ...}"
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Nothing found (not charged)"
          },
          "503": {
            "description": "Upstream index unavailable (not charged)"
          }
        },
        "operationId": "refcheck",
        "parameters": [
          {
            "name": "refs",
            "in": "query",
            "required": false,
            "description": "Reference list: one per line or blank-line separated, or BibTeX entries. Up to 12 references, 9000 characters. Omit for a demo.",
            "schema": {
              "type": "string"
            },
            "example": "Vaswani, A., Shazeer, N., Parmar, N., Uszkoreit, J., Jones, L., Gomez, A. N., Kaiser, L., & Polosukhin, I. (2017). Attention is all you need. Advances in Neural Information Processing Systems 30.\nDevlin, J., Chang, M.-W., Lee, K., & Toutanova, K. (2018). BERT: Pre-training of deep bidirectional transformers for language understanding. arXiv:1810.04805."
          }
        ]
      },
      "post": {
        "summary": "Reference Checker (catch hallucinated citations)",
        "description": "Paste a reference list (APA/MLA/Chicago/IEEE/Vancouver lines, a numbered list, or BibTeX; up to 12 per call) and get each one checked against Crossref, DBLP and arXiv: verified / verified_with_issues / partial_match / not_found, with the exact problem (fabricated reference, DOI that points to a different paper, wrong year, wrong first author, garbled title, missing DOI), the canonical record, and a corrected APA + BibTeX entry. For agents that write reports, literature reviews, papers or answers with citations: run it before you ship. No input = demo list with one fabricated and two corrupted references.",
        "tags": [
          "citations",
          "references",
          "hallucination",
          "fact-check",
          "academic",
          "bibtex",
          "doi",
          "crossref",
          "arxiv",
          "research",
          "writing"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.05"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "50000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Reference Checker (catch hallucinated citations): $0.05 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "summary",
                    "results"
                  ],
                  "properties": {
                    "demo": {
                      "type": "boolean"
                    },
                    "summary": {
                      "type": "object",
                      "properties": {
                        "total": {
                          "type": "integer"
                        },
                        "verified": {
                          "type": "integer"
                        },
                        "verified_with_issues": {
                          "type": "integer"
                        },
                        "partial_match": {
                          "type": "integer"
                        },
                        "not_found": {
                          "type": "integer"
                        },
                        "risk": {
                          "type": "string",
                          "enum": [
                            "low",
                            "medium",
                            "high"
                          ]
                        },
                        "flagged": {
                          "type": "integer"
                        }
                      }
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "n": {
                            "type": "integer"
                          },
                          "input": {
                            "type": "string"
                          },
                          "verdict": {
                            "type": "string",
                            "enum": [
                              "verified",
                              "verified_with_issues",
                              "partial_match",
                              "not_found"
                            ]
                          },
                          "confidence": {
                            "type": "number"
                          },
                          "issues": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "match": {
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "corrected": {
                            "type": [
                              "object",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "upstream": {
                      "type": "object"
                    },
                    "method": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "summary": {
                    "total": 5,
                    "verified": 1,
                    "verified_with_issues": 2,
                    "partial_match": 0,
                    "not_found": 1,
                    "risk": "high",
                    "flagged": 4
                  },
                  "results": [
                    {
                      "n": 4,
                      "input": "Lewis, P., ... (2020). Retrieval-augmented generation ... https://doi.org/10.1126/science.1225829",
                      "verdict": "verified_with_issues",
                      "confidence": 0.98,
                      "issues": [
                        "doi_mismatch: 10.1126/science.1225829 belongs to a different work (\"A Programmable Dual-RNA-Guided DNA Endonuclease in Adaptive Bacterial Immunity\", 2012)"
                      ],
                      "match": {
                        "title": "Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks",
                        "authors": [
                          "Patrick S. H. Lewis"
                        ],
                        "year": 2020,
                        "venue": "NeurIPS",
                        "doi": null,
                        "arxiv": "2005.11401",
                        "source": "dblp"
                      },
                      "corrected": {
                        "apa": "Lewis, P. S. H., ... (2020). Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks. In NeurIPS.",
                        "bibtex": "@inproceedings{lewis2020retrieval, ...}"
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Nothing found (not charged)"
          },
          "503": {
            "description": "Upstream index unavailable (not charged)"
          }
        },
        "operationId": "refcheck_post",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "refs": {
                    "type": "string",
                    "description": "Reference list: one per line or blank-line separated, or BibTeX entries. Up to 12 references, 9000 characters. Omit for a demo.",
                    "example": "Vaswani, A., Shazeer, N., Parmar, N., Uszkoreit, J., Jones, L., Gomez, A. N., Kaiser, L., & Polosukhin, I. (2017). Attention is all you need. Advances in Neural Information Processing Systems 30.\nDevlin, J., Chang, M.-W., Lee, K., & Toutanova, K. (2018). BERT: Pre-training of deep bidirectional transformers for language understanding. arXiv:1810.04805."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/v1/arxiv/latest": {
      "get": {
        "summary": "arXiv Latest Digest (any category, optional keywords)",
        "description": "The newest arXiv papers in any category (cs.AI, cs.CL, cs.LG, stat.ML, q-bio, physics, math...), optionally filtered by keywords: up to 50 papers with title, authors, a 1-2 sentence summary, categories, comments (e.g. \"accepted at ICLR\"), journal ref, abs/pdf links, plus papers per day and trending terms. For research-monitoring agents that check a field daily and for newsletter/alert pipelines. No input = latest cs.AI.",
        "tags": [
          "arxiv",
          "research",
          "papers",
          "daily",
          "digest",
          "monitoring",
          "ai",
          "machine-learning",
          "science",
          "alerts",
          "preprints"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.02"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "20000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "arXiv Latest Digest (any category, optional keywords): $0.02 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "category",
                    "count",
                    "papers"
                  ],
                  "properties": {
                    "demo": {
                      "type": "boolean"
                    },
                    "category": {
                      "type": "string"
                    },
                    "q": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "generatedAt": {
                      "type": "string"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "window": {
                      "type": "object"
                    },
                    "byDay": {
                      "type": "array"
                    },
                    "trendingTerms": {
                      "type": "array"
                    },
                    "papers": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "source": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "demo": false,
                  "category": "cs.AI",
                  "q": null,
                  "count": 25,
                  "window": {
                    "newest": "2026-11-20",
                    "oldest": "2026-11-19"
                  },
                  "byDay": [
                    {
                      "date": "2026-11-20",
                      "papers": 14
                    }
                  ],
                  "trendingTerms": [
                    {
                      "term": "language models",
                      "papers": 9
                    }
                  ],
                  "papers": [
                    {
                      "arxiv": "2611.01234",
                      "title": "...",
                      "authors": [
                        "A. Author"
                      ],
                      "published": "2026-11-20",
                      "primary": "cs.AI",
                      "categories": [
                        "cs.AI",
                        "cs.CL"
                      ],
                      "tldr": "...",
                      "abs": "https://arxiv.org/abs/2611.01234",
                      "pdf": "https://arxiv.org/pdf/2611.01234"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Nothing found (not charged)"
          },
          "503": {
            "description": "Upstream index unavailable (not charged)"
          }
        },
        "operationId": "arxiv_latest",
        "parameters": [
          {
            "name": "cat",
            "in": "query",
            "required": false,
            "description": "arXiv category, e.g. cs.AI, cs.CL, cs.LG, cs.CV, stat.ML, q-bio.GN, quant-ph (default cs.AI).",
            "schema": {
              "type": "string"
            },
            "example": "cs.AI"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Optional keywords that must appear in title or abstract (e.g. \"agents tool use\").",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "n",
            "in": "query",
            "required": false,
            "description": "Number of papers, 5-50 (default 25).",
            "schema": {
              "type": "integer"
            },
            "example": 25
          }
        ]
      },
      "post": {
        "summary": "arXiv Latest Digest (any category, optional keywords)",
        "description": "The newest arXiv papers in any category (cs.AI, cs.CL, cs.LG, stat.ML, q-bio, physics, math...), optionally filtered by keywords: up to 50 papers with title, authors, a 1-2 sentence summary, categories, comments (e.g. \"accepted at ICLR\"), journal ref, abs/pdf links, plus papers per day and trending terms. For research-monitoring agents that check a field daily and for newsletter/alert pipelines. No input = latest cs.AI.",
        "tags": [
          "arxiv",
          "research",
          "papers",
          "daily",
          "digest",
          "monitoring",
          "ai",
          "machine-learning",
          "science",
          "alerts",
          "preprints"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.02"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "20000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "arXiv Latest Digest (any category, optional keywords): $0.02 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "category",
                    "count",
                    "papers"
                  ],
                  "properties": {
                    "demo": {
                      "type": "boolean"
                    },
                    "category": {
                      "type": "string"
                    },
                    "q": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "generatedAt": {
                      "type": "string"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "window": {
                      "type": "object"
                    },
                    "byDay": {
                      "type": "array"
                    },
                    "trendingTerms": {
                      "type": "array"
                    },
                    "papers": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "source": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "demo": false,
                  "category": "cs.AI",
                  "q": null,
                  "count": 25,
                  "window": {
                    "newest": "2026-11-20",
                    "oldest": "2026-11-19"
                  },
                  "byDay": [
                    {
                      "date": "2026-11-20",
                      "papers": 14
                    }
                  ],
                  "trendingTerms": [
                    {
                      "term": "language models",
                      "papers": 9
                    }
                  ],
                  "papers": [
                    {
                      "arxiv": "2611.01234",
                      "title": "...",
                      "authors": [
                        "A. Author"
                      ],
                      "published": "2026-11-20",
                      "primary": "cs.AI",
                      "categories": [
                        "cs.AI",
                        "cs.CL"
                      ],
                      "tldr": "...",
                      "abs": "https://arxiv.org/abs/2611.01234",
                      "pdf": "https://arxiv.org/pdf/2611.01234"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Nothing found (not charged)"
          },
          "503": {
            "description": "Upstream index unavailable (not charged)"
          }
        },
        "operationId": "arxiv_latest_post",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "cat": {
                    "type": "string",
                    "description": "arXiv category, e.g. cs.AI, cs.CL, cs.LG, cs.CV, stat.ML, q-bio.GN, quant-ph (default cs.AI).",
                    "example": "cs.AI"
                  },
                  "q": {
                    "type": "string",
                    "description": "Optional keywords that must appear in title or abstract (e.g. \"agents tool use\")."
                  },
                  "n": {
                    "type": "integer",
                    "description": "Number of papers, 5-50 (default 25).",
                    "example": 25
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/v1/cite": {
      "get": {
        "summary": "Cite Anything (DOI / arXiv / title -> 8 citation styles)",
        "description": "Give a DOI, an arXiv id or URL, or just a paper title: get the verified record (authors, year, venue, volume, pages, DOI, citation count, abstract) and ready-to-paste citations in BibTeX, RIS, APA 7, MLA 9, Chicago, IEEE, Harvard and Vancouver, plus in-text forms. For arXiv preprints it finds the peer-reviewed version (e.g. NeurIPS/ACL via DBLP) and formats that too. Unknown id = 404, not charged. No input = demo (arXiv 1706.03762).",
        "tags": [
          "citation",
          "bibtex",
          "apa",
          "mla",
          "ieee",
          "doi",
          "arxiv",
          "reference",
          "academic",
          "research",
          "writing"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "10000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Cite Anything (DOI / arXiv / title -> 8 citation styles): $0.01 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "paper",
                    "citations"
                  ],
                  "properties": {
                    "demo": {
                      "type": "boolean"
                    },
                    "query": {
                      "type": "string"
                    },
                    "paper": {
                      "type": "object"
                    },
                    "citations": {
                      "type": "object"
                    },
                    "markdown": {
                      "type": "object"
                    },
                    "inText": {
                      "type": "object"
                    },
                    "publishedVersion": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "checked": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "demo": false,
                  "query": "1706.03762",
                  "paper": {
                    "title": "Attention Is All You Need",
                    "authors": [
                      "Ashish Vaswani",
                      "Noam Shazeer"
                    ],
                    "year": 2017,
                    "venue": "arXiv",
                    "doi": null,
                    "arxiv": "1706.03762",
                    "url": "https://arxiv.org/abs/1706.03762",
                    "type": "preprint",
                    "source": "arxiv"
                  },
                  "citations": {
                    "bibtex": "@misc{vaswani2017attention, ...}",
                    "apa": "Vaswani, A., Shazeer, N., ... (2017). Attention Is All You Need. arXiv. https://doi.org/10.48550/arXiv.1706.03762",
                    "ieee": "A. Vaswani et al., \"Attention Is All You Need,\" arXiv:1706.03762, 2017."
                  },
                  "inText": {
                    "apa": "(Vaswani et al., 2017)"
                  },
                  "publishedVersion": {
                    "venue": "NIPS",
                    "year": 2017,
                    "pages": "5998-6008",
                    "source": "dblp",
                    "citations": {
                      "apa": "Vaswani, A., ... (2017). Attention is All you Need. In NIPS (pp. 5998–6008)."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Nothing found (not charged)"
          },
          "503": {
            "description": "Upstream index unavailable (not charged)"
          }
        },
        "operationId": "cite",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": false,
            "description": "DOI (10.xxxx/...), doi.org URL, arXiv id (2005.11401) or arxiv.org URL, or a paper title. Omit for a demo.",
            "schema": {
              "type": "string"
            },
            "example": "1706.03762"
          },
          {
            "name": "style",
            "in": "query",
            "required": false,
            "description": "One style only (default all).",
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "bibtex",
                "ris",
                "apa",
                "mla",
                "chicago",
                "ieee",
                "harvard",
                "vancouver"
              ]
            },
            "example": "all"
          }
        ]
      },
      "post": {
        "summary": "Cite Anything (DOI / arXiv / title -> 8 citation styles)",
        "description": "Give a DOI, an arXiv id or URL, or just a paper title: get the verified record (authors, year, venue, volume, pages, DOI, citation count, abstract) and ready-to-paste citations in BibTeX, RIS, APA 7, MLA 9, Chicago, IEEE, Harvard and Vancouver, plus in-text forms. For arXiv preprints it finds the peer-reviewed version (e.g. NeurIPS/ACL via DBLP) and formats that too. Unknown id = 404, not charged. No input = demo (arXiv 1706.03762).",
        "tags": [
          "citation",
          "bibtex",
          "apa",
          "mla",
          "ieee",
          "doi",
          "arxiv",
          "reference",
          "academic",
          "research",
          "writing"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "10000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Cite Anything (DOI / arXiv / title -> 8 citation styles): $0.01 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "paper",
                    "citations"
                  ],
                  "properties": {
                    "demo": {
                      "type": "boolean"
                    },
                    "query": {
                      "type": "string"
                    },
                    "paper": {
                      "type": "object"
                    },
                    "citations": {
                      "type": "object"
                    },
                    "markdown": {
                      "type": "object"
                    },
                    "inText": {
                      "type": "object"
                    },
                    "publishedVersion": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "checked": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "demo": false,
                  "query": "1706.03762",
                  "paper": {
                    "title": "Attention Is All You Need",
                    "authors": [
                      "Ashish Vaswani",
                      "Noam Shazeer"
                    ],
                    "year": 2017,
                    "venue": "arXiv",
                    "doi": null,
                    "arxiv": "1706.03762",
                    "url": "https://arxiv.org/abs/1706.03762",
                    "type": "preprint",
                    "source": "arxiv"
                  },
                  "citations": {
                    "bibtex": "@misc{vaswani2017attention, ...}",
                    "apa": "Vaswani, A., Shazeer, N., ... (2017). Attention Is All You Need. arXiv. https://doi.org/10.48550/arXiv.1706.03762",
                    "ieee": "A. Vaswani et al., \"Attention Is All You Need,\" arXiv:1706.03762, 2017."
                  },
                  "inText": {
                    "apa": "(Vaswani et al., 2017)"
                  },
                  "publishedVersion": {
                    "venue": "NIPS",
                    "year": 2017,
                    "pages": "5998-6008",
                    "source": "dblp",
                    "citations": {
                      "apa": "Vaswani, A., ... (2017). Attention is All you Need. In NIPS (pp. 5998–6008)."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Nothing found (not charged)"
          },
          "503": {
            "description": "Upstream index unavailable (not charged)"
          }
        },
        "operationId": "cite_post",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "DOI (10.xxxx/...), doi.org URL, arXiv id (2005.11401) or arxiv.org URL, or a paper title. Omit for a demo.",
                    "example": "1706.03762"
                  },
                  "style": {
                    "type": "string",
                    "description": "One style only (default all).",
                    "enum": [
                      "all",
                      "bibtex",
                      "ris",
                      "apa",
                      "mla",
                      "chicago",
                      "ieee",
                      "harvard",
                      "vancouver"
                    ],
                    "example": "all"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/v1/pass": {
      "get": {
        "summary": "Research day pass: 24 hours, up to 200 calls",
        "description": "Buy once, research all day: a signed token for up to 200 calls to every Quill Scholar route (literature review packs, reference checks, arXiv digests, citations) for 24 hours. Send it as Authorization: Bearer <token> or X-Quill-Pass: <token>. Pays for itself after 4 review packs or 20 reference checks.",
        "tags": [
          "research",
          "academic",
          "subscription",
          "day-pass",
          "prepaid",
          "literature-review",
          "citations"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "1"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "1000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Research day pass: 24 hours, up to 200 calls: $1.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pass": {
                      "type": "string"
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "max_calls": {
                      "type": "integer"
                    },
                    "use": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "pass",
                    "expires_at"
                  ]
                },
                "example": {
                  "pass": "qp1.eyJ2IjoxLC4uLn0.abc",
                  "expires_at": "2026-11-23T00:00:00.000Z",
                  "max_calls": 200,
                  "use": "Send Authorization: Bearer <pass> ..."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Nothing found (not charged)"
          },
          "503": {
            "description": "Upstream index unavailable (not charged)"
          }
        },
        "operationId": "pass",
        "parameters": []
      },
      "post": {
        "summary": "Research day pass: 24 hours, up to 200 calls",
        "description": "Buy once, research all day: a signed token for up to 200 calls to every Quill Scholar route (literature review packs, reference checks, arXiv digests, citations) for 24 hours. Send it as Authorization: Bearer <token> or X-Quill-Pass: <token>. Pays for itself after 4 review packs or 20 reference checks.",
        "tags": [
          "research",
          "academic",
          "subscription",
          "day-pass",
          "prepaid",
          "literature-review",
          "citations"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "1"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "1000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Research day pass: 24 hours, up to 200 calls: $1.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pass": {
                      "type": "string"
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "max_calls": {
                      "type": "integer"
                    },
                    "use": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "pass",
                    "expires_at"
                  ]
                },
                "example": {
                  "pass": "qp1.eyJ2IjoxLC4uLn0.abc",
                  "expires_at": "2026-11-23T00:00:00.000Z",
                  "max_calls": 200,
                  "use": "Send Authorization: Bearer <pass> ..."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Nothing found (not charged)"
          },
          "503": {
            "description": "Upstream index unavailable (not charged)"
          }
        },
        "operationId": "pass_post",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health/ai": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health/upstream": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "operationId": "mcp",
        "summary": "Remote MCP server (Streamable HTTP, JSON-RPC 2.0, stateless). search_papers is free; paid tools need a Quill Research Pass as the header Authorization: Bearer <token>.",
        "security": [],
        "responses": {
          "200": {
            "description": "JSON-RPC response"
          }
        }
      }
    },
    "/v1/pass/transfer": {
      "get": {
        "operationId": "pass_transfer_instructions",
        "summary": "Free: how to buy a research pass with a plain USDC transfer on Base (1 / 5 / 15 USDC = 24 h / 7 days / 30 days)",
        "security": [],
        "responses": {
          "200": {
            "description": "Instructions"
          }
        }
      }
    },
    "/v1/pass/redeem": {
      "get": {
        "operationId": "pass_redeem",
        "summary": "Free: redeem the tx hash of a plain USDC transfer on Base for a research pass token (idempotent)",
        "security": [],
        "parameters": [
          {
            "name": "tx",
            "in": "query",
            "required": true,
            "description": "0x-prefixed transaction hash of the USDC transfer on Base",
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Pass token",
            "content": {
              "application/json": {
                "example": {
                  "pass": "qp1.eyJ2IjoxLC4uLn0.abc",
                  "plan": "week",
                  "expires_at": "2026-11-29T12:00:00.000Z",
                  "max_calls": 1500,
                  "paid_usdc": "5",
                  "tx": "0x…"
                }
              }
            }
          },
          "402": {
            "description": "No qualifying USDC transfer to payTo in this tx"
          },
          "404": {
            "description": "Not found on Base yet"
          },
          "409": {
            "description": "x402 payment (not redeemable)"
          },
          "410": {
            "description": "Pass window over"
          }
        }
      }
    }
  }
}