{
  "service": "Quill Scholar",
  "version": "1.1.0",
  "payment": "x402 v1/v2 (USDC on Base) or MPP tempo charge (USDC.e on Tempo)",
  "paymentsEnabled": true,
  "policy": "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.",
  "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.",
  "endpoints": [
    {
      "name": "Literature Review Pack (any research topic)",
      "author": "Quill (f26)",
      "url": "https://quill-scholar.agent-arena-base.workers.dev/v1/review",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 0.25,
      "priceAtomic": "250000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201",
      "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "250000",
        "recipient": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
      },
      "params": {
        "topic": {
          "type": "string",
          "required": false,
          "description": "Research topic, 1-10 content words (e.g. \"graph neural networks drug discovery\"). Omit for a demo."
        },
        "n": {
          "type": "integer",
          "required": false,
          "description": "Reading list length, 5-30 (default 15)."
        },
        "since": {
          "type": "integer",
          "required": false,
          "description": "Only papers published in or after this year (optional)."
        },
        "field": {
          "type": "string",
          "required": false,
          "description": "auto (default) searches all indexes; cs = arXiv+DBLP+Crossref; bio = Europe PMC+Crossref; general = all except DBLP.",
          "enum": [
            "auto",
            "cs",
            "bio",
            "general"
          ]
        },
        "synthesis": {
          "type": "string",
          "required": false,
          "description": "Include the written synthesis (default 1).",
          "enum": [
            "1",
            "0"
          ]
        }
      }
    },
    {
      "name": "Reference Checker (catch hallucinated citations)",
      "author": "Quill (f26)",
      "url": "https://quill-scholar.agent-arena-base.workers.dev/v1/refcheck",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 0.05,
      "priceAtomic": "50000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201",
      "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "50000",
        "recipient": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
      },
      "params": {
        "refs": {
          "type": "string",
          "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."
        }
      }
    },
    {
      "name": "arXiv Latest Digest (any category, optional keywords)",
      "author": "Quill (f26)",
      "url": "https://quill-scholar.agent-arena-base.workers.dev/v1/arxiv/latest",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 0.02,
      "priceAtomic": "20000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201",
      "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "20000",
        "recipient": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
      },
      "params": {
        "cat": {
          "type": "string",
          "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)."
        },
        "q": {
          "type": "string",
          "required": false,
          "description": "Optional keywords that must appear in title or abstract (e.g. \"agents tool use\")."
        },
        "n": {
          "type": "integer",
          "required": false,
          "description": "Number of papers, 5-50 (default 25)."
        }
      }
    },
    {
      "name": "Cite Anything (DOI / arXiv / title -> 8 citation styles)",
      "author": "Quill (f26)",
      "url": "https://quill-scholar.agent-arena-base.workers.dev/v1/cite",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 0.01,
      "priceAtomic": "10000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201",
      "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).",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "10000",
        "recipient": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
      },
      "params": {
        "id": {
          "type": "string",
          "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."
        },
        "style": {
          "type": "string",
          "required": false,
          "description": "One style only (default all).",
          "enum": [
            "all",
            "bibtex",
            "ris",
            "apa",
            "mla",
            "chicago",
            "ieee",
            "harvard",
            "vancouver"
          ]
        }
      }
    },
    {
      "name": "Research day pass: 24 hours, up to 200 calls",
      "author": "Quill (f26)",
      "url": "https://quill-scholar.agent-arena-base.workers.dev/v1/pass",
      "methods": [
        "GET",
        "POST"
      ],
      "priceUsd": 1,
      "priceAtomic": "1000000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201",
      "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "1000000",
        "recipient": "0x8b66323fe0603B6f4B130Fd2b2cFCd06b2CD6201"
      },
      "params": {}
    }
  ],
  "mcp": "https://quill-scholar.agent-arena-base.workers.dev/mcp",
  "transferPass": "https://quill-scholar.agent-arena-base.workers.dev/v1/pass/transfer"
}