Kutip Documentation

An autonomous AI research agent that pays cited authors in USDC, attested on Kite chain.

Welcome. These pages cover everything from "click this and run a query" to "audit the on-chain conservation invariants in our fuzz suite."

---

Pick your entry point

I want to use Kutip

Quickstart → · Run the demo flow in under 5 minutes. No setup, no wallet required for the first query.

Live deployment · Production on Kite testnet, real attestations, real authors getting paid.

I want to integrate with Kutip

Integration overview · Three paths — MCP for LLM agents, HTTP API for backends, on-chain reads for indexers.

MCP server · Plug Kutip into Claude Desktop / Cursor / Cline as a research tool.

I want to understand the system

Architecture · Identities, contracts, money flow, attestation lifecycle.

Agent Passport · How EIP-712 session delegation + Kite Passport vault gate agent spending.

Gasless flow · Why end users sign once and never pay gas after.

I want to verify Kutip is safe

Security model · Threat model, mitigations, four rounds of audit findings + fixes.

Testing guide · 56 Foundry tests (4 fuzz suites at 256 runs each) + 143 Vitest unit + 6 integration. Conventions for adding new tests.

I'm shipping a fork or my own deployment

Deployment · Contract deploy order, env vars, Vercel setup, the "what each address controls" map.

QA checklist · Pre-submission verification matrix — every demo path, every chain, every failure mode.

---

Quickstart

# Prereqs: Node 20+, pnpm, Foundry, a wallet (MetaMask recommended)

# 1. Clone + install
git clone https://github.com/PugarHuda/kutip.git
cd kutip/web && pnpm install

# 2. Copy env template + fill in essentials
cp ../.env.example ../.env
# Minimum required:
#   PRIVATE_KEY=<your dev wallet, funded on Kite testnet>
#   OPENROUTER_API_KEY=<free at openrouter.ai>

# 3. (Optional) Deploy your own contracts
cd ../contracts && forge install && forge build
forge script script/DeployAttribution.s.sol --broadcast --rpc-url https://rpc-testnet.gokite.ai/

# 4. Run the web app
cd ../web && pnpm dev
# → http://localhost:3000

# 5. Run a query (no wallet needed for demo budgets)
open http://localhost:3000/dashboard

Need real funds on Kite testnet? Use the Kite faucet.

---

Other guides

• Demo script — the 90-second walkthrough used in the submission video
• Screenshot guide — captures judges see in the Encode form
• Submission copy — Encode-form-ready blurbs
• Plan & milestones — sprint plan with completed milestones

---

Where things live

---

Questions, bugs, contributions

• Report bugs: https://github.com/PugarHuda/kutip/issues
• Hackathon entry: Kite AI Global Hackathon 2026 · Novel track · deadline 2026-05-18

Built for the agentic economy, where citation is currency.