io.github.tang-vu/keryx

Ask Keryx — an autonomous research agent that buys paid sources under a budget, answers with inline citations, and pays each cited creator in USDC on Arc. Default deep-mode price is 0.05 USDC service fee + 0.05 USDC creator budget; the POST body sets the exact price. Paid from your own funded Arc Testnet wallet (eip155:5042002; run keryx_wallet_status first). Public research may send your question to Keryx's search provider. The source USDC budget is separate from model and search operating costs. New hosted runs are attributed to the verified paying wallet through agent-to-agent ingress; editable client metadata does not prove stdio identity or grant additional rights. Use when you want a grounded, source-cited answer AND the creators paid for their work. For title, ordered authors, year, journal, DOI or exact arXiv version without reading paper findings, use free paper_lookup with an exact identifier instead.

Run hosted sponsored research without a buyer wallet, funding or API key. Requires publicReport: true: your question and trial report become public. Server quota, pause and spending limits apply; source budget is 0–0.08 USDC, separate from model/search costs. This creates a new research run and may contact external sources. No automatic retry or paid fallback. Timeouts/disconnects may leave server work running; do not resend automatically. For a separately authorized purchase from your own funded wallet, use the paid buyer tool ask_keryx.

Checks both recorded payload SHA-256 digests, then compares retained excerpt rows with exact source/item/URL/version identity and reading context. Unique identical target text is matched automatically; matches can explicitly select one-to-one target pairs. Or supply matchingPlan JSON to restore choices bound to these receipts in this order; never combine both options. Returns a reusable matchingPlan without report text alongside the comparison. Duplicate or renamed targets are not guessed. Missing historical ledgers remain unknown. This is a local stdio operation without fetching, database, model, payment or reward I/O. A checksum is not authenticity, factual support or improvement. Your MCP client may retain all supplied text; use the web file tool for browser-memory-only inspection.

Owner-only ordinary prepaid A2A deliverable state. Requires explicit deliverable:read. Historical remedy:none and missing response window remain visible. Native/enrolled, Monthly, private v2 and browser-only originals are unavailable. Not source-decision agreement or semantic verification.

Record Accept, Request revision or Reject for the original customer's exact retained delivery. Requires explicit deliverable:write, expected current revision/digests and an idempotency key. Reason is private; publishState explicitly shares state/timestamp only. Request storage does not execute a revision/refund, recharge, change reservations or claw back rewards. Your MCP client may retain private messages.

Split a private passage into sentences, bind citation markers ([3], cite{key}, [@key], Author (Year)) to a BibTeX, RIS or DOI/link reference list, and compare each cited sentence with source text you supply. Each verdict (supported, partly-supported, not-found, source-unavailable) carries a verbatim excerpt of that text or states that no supporting passage was found; a source without supplied text is always source-unavailable. Deterministic wording comparison, not semantic review. No fetching, model, database, history, payment or reward I/O. Inputs and results can be retained by your MCP client; choose that client’s privacy settings before sharing private passages.

Assemble user-selected claim spans and related-work quote themes from saved Include paper records and caller-supplied retained Keryx report rows. A theme may carry author-written statements (contribution, agreement, disagreement, gap); a statement naming a paper is exported only with a citation and a selected retained excerpt from each named paper, otherwise it is withheld. Exported citations and BibTeX/RIS entries are checked to correspond one to one. Exact version/excerpt matching does not authenticate imported reports or verify semantic support. No fetching, model, database, history, payment or reward I/O. Inputs and returned draft can be retained by your MCP client; choose that client’s privacy settings before sharing private passages.

Assess missing evidence requirements, supplied provider offers, selections, deliveries and caller reviews with the shared private evidence procurement contract. Amounts are exact integer micro-USDC. Signature and content-binding checks do not establish delivery quality, buyer authority, payment or settlement. No fetching, model, provider, database, history, purchase, escrow or reward I/O. Caller selections and reviews are assertions, not financial authorization. Inputs and results may be retained by your MCP client; choose its privacy settings before sharing private material.

Convert a caller-supplied Keryx personal-bibliography v1 JSON backup (at most 1048576 UTF-8 bytes) to BibTeX, RIS, CSL-JSON or an inspectable Markdown bibliography. Markdown retains literal metadata/provenance with explicit unknown fields; it is not a literature synthesis. Optionally supply paperUrls: at most 50 unique exact saved landing URLs, in desired output order; an empty array exports no papers and missing/changed URLs refuse the entire export. An optional screening state further filters that selection. Without paperUrls keeps saved order. Validates the full backup and preserves exact versions/provenance. Output omits private review title, question, notes and screening decisions. Metadata only: no read, citation, peer-review or settlement certification. No fetching, file access, model, database, wallet or payment I/O. Your MCP client may retain the full supplied backup, including private notes; prefer the browser tool when those bytes should remain in browser memory.

Same owner-private v2 contract as /api/me/asks. Explicit history:read required. Current store, bounded filters/keysets; missing membership/claims stay explicit. Export has explicit truncation/continuation. No research, signer, payment, public-owner selector or mutation authority.

Same owner-private v2 contract as /api/me/asks. Explicit history:read required. Current store, bounded filters/keysets; missing membership/claims stay explicit. Export has explicit truncation/continuation. No research, signer, payment, public-owner selector or mutation authority.

Private data for this authenticated caller only. Exact-payer completed private jobs in the current store; explicit history:read required. Bounded scan/continuation, unknown provenance and NULL own spend/creator settlement remain explicit. No wallet selector, public report/share link, model prompt, research, source fetch, signer, purchase or mutation authority.

Private data for this authenticated caller only. Exact-payer completed private jobs in the current store; explicit history:read required. Bounded scan/continuation, unknown provenance and NULL own spend/creator settlement remain explicit. No wallet selector, public report/share link, model prompt, research, source fetch, signer, purchase or mutation authority. Manual finite JSON metadata export only; complete/truncated and continuation are returned. Result bodies are excluded.

Private data for this authenticated caller only. Exact-payer completed private jobs in the current store; explicit history:read required. Bounded scan/continuation, unknown provenance and NULL own spend/creator settlement remain explicit. No wallet selector, public report/share link, model prompt, research, source fetch, signer, purchase or mutation authority.

Read bounded pages of the verified API-key wallet's ordinary current-store runs. Requires explicit history:read. Literal case-sensitive question search; storeNetwork describes the deployment, not per-run settlement. Recorded spend/allocation is not a payment receipt. No wallet selector, linked accounts, archive, private jobs, research or payment.

Validate a caller-supplied Keryx personal-bibliography v1 JSON backup and return aggregate counts for saved records, personal screening, repositories, recorded publication types and missing metadata. Optional baselineBackup adds a redacted comparison: baseline is before, backup is after, regardless of timestamps. Each supplied JSON string is limited to 1048576 UTF-8 bytes and fully validated. Records match only by exact saved URL; separate versions remain separate. Report added/removed records, overlapping retained-record field changes, retained relative order and review-focus changes. Metadata observation timestamps are separate from bibliographic changes. Output omits actual private review text, notes and paper identities. Counts establish no quality, lookup, reading, peer-review, withdrawal, authenticity or settlement claim. No file, network, model, database, wallet or payment I/O. Your MCP client may retain both complete supplied backups, including private notes; prefer the browser workspace when those bytes should remain there.

Observe public prepaid research operations, queue, recorded ordinary/recovered/unknown completion latency cohorts and hold/review rationale. Timing is order createdAt to updatedAt (acceptance to recorded completion/update); later reconciliation can extend it. It is not first-answer or settlement time. Missing capability stays null. No spending or execution authority; exact books and customer jobs stay private.

Inspect a partial selected-network public web-dispatch transfer ledger and balanced exact micro-USDC vouchers. Browser funding and Keryx sponsorship are separate. Pending/ambiguous/batched-attribution legs do not enter settled totals. No customer questions/identities, private invoices, complete business books, margin, cash balance, signing or execution authority. days1–31, default7. Export via /api/operator/ledger; a checksum is not authenticity or independent settlement proof.

Read a public dispatch's retained exact-version BUY/citation/payment observations. Returns bounded sample counts, citation hit rate, calibration bands and integer micro-USDC uncited access cost. Recorded settlement is not revalidated on chain. Historical participant cohort is unknown; causal regret, missed value and cost per supported claim are unmeasured. No research, paid read, current-source backfill, private reviews, signing or learning. Use an existing dispatch ID, never a URL.

Read the saved payment attempt and poll its query ID without submitting another payment. Use after a paid error or uncertain network outcome.

Read the same bounded observational source/topic record as the public creator page and API. Only write-time independently classified/funded outside observations qualify; owners, unknown and private history are excluded. Source-declared public topics, counts, recorded citation contribution, exact rational average access price, descriptive uncertainty and abrupt-shift flag. No questions, wallets or receipt identifiers. Recorded settlement is not independently revalidated. Live learned selection and exploration are withheld, with zero live exploration allowance. No research, source read, payment, private inspection or policy activation.

Show the configured Arc Testnet wallet (eip155:5042002) the Keryx MCP server pays from: address, balances and readiness. Testnet funds are available through the Circle faucet. Run this before ask_keryx.

Read a private conservative obligation projection for the exact server-delegated reader with explicit operator:read API-key scope. Disabled without protected reader/role configuration. Partial native history remains unknown with zero safe/advisory surplus. No cash probe, signer, custody, spending, release, refund or scheduler authority. No caller owner/role selectors.

Find paper titles, recorded contributors, DOI and exact repository versions without research or payment. Default: retained catalog metadata with observation times. Set searchRepositories=true only to explicitly send the query to arXiv/Crossref (at most two requests, no paper-body reading). Missing DOI, peer review and withdrawal/replacement status remain unknown. Returns a field-scoped bibliography card with provenance, a short reference and reusable BibTeX/RIS text. Use this for exact title/ordered author/year/journal/DOI/version questions before requesting paid research; original paper text is not required for recorded metadata.

Read only the verified key owner's saved ORCID/GitHub identities. Requires explicit profile:read scope. No wallet selector, provider OAuth, linking, unlinking, research or payment. Link identities interactively in your private profile browser page.

Read the verified key owner's private profile and attributed activity. Requires explicit profile:read scope. No public identity, research or payment.

Replace the verified key owner's private display name, handle, one-line bio/purpose and links. Requires explicit profile:write scope. No wallet selector or identity verification; no payment/history changes.

Original-caller private opinion on the exact delivered ordinary research answer. Requires its private bearer capability; a public report ID or link grants no authority. First choice is retained, exact retries are idempotent. Silence is no response. No research, source fetching, revision execution, refunds, signing or payments.

Original-caller private opinion on the exact delivered ordinary research answer. Requires its private bearer capability; a public report ID or link grants no authority. First choice is retained, exact retries are idempotent. Silence is no response. No research, source fetching, revision execution, refunds, signing or payments.

Read the four-request, 30-day Research Monthly quote and handoff. The current quote identifies its payment network. Never buys or redeems a plan.

Owner-private current-store read using the verified key's explicit history:read scope. No wallet selector or signing. Visibility, defaults and erasure require the interactive web session. Storage admission is required.

Owner-private current-store read using the verified key's explicit history:read scope. No wallet selector or signing. Visibility, defaults and erasure require the interactive web session. Storage admission is required.