# GET /library/research: $0.10 per call

Premium research report on a library or API for coding agents: reads its current docs for your goal, checks version, safety and repository health, gathers what developers actually hit (Stack Overflow, the busiest open GitHub issues, Hacker News) and writes a cited brief: summary, how to do your goal with code, gotchas, risks. ?library=hono&goal=...

- **Price:** $0.10 in USDC, the same on Base, Solana, Polygon, Arbitrum. Failed calls are never charged.
- **Free trial:** no, paid only (it uses a paid AI model or data source, or costs more than the trial covers). Other ways to pay: x402 or [prepaid credits](/credits).
- **Tier:** deep
- **Answers cached for:** 12 hour(s)
- **Data sources:** Project docs / llms.txt (free); deps.dev, OSV.dev, registries (free); GitHub REST (free); Stack Overflow, Hacker News (free); Workers AI (metered)
- **Lane:** AI coding agents ([OpenAPI](/openapi/coding.json))
- **Live health:** [status page](/status)

## Free sample

See an answer for the demo input first, free (no payment, 10 a minute): [https://aayatai.com/sample/library-research](/sample/library-research). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

```bash
curl "https://aayatai.com/sample/library-research"
```

## 1. See the price (free)

Call it without paying: you get `402 Payment Required` and a `PAYMENT-REQUIRED` header with the exact price and where to pay.

```bash
curl -i "https://aayatai.com/library/research?library=hono&ecosystem=npm&goal=enable+CORS"
```

## 2. Pay and call (TypeScript)

```bash
npm install @x402/fetch @x402/evm viem
```

```ts
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// A wallet used only by your agent, holding a little USDC on Base.
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await pay("https://aayatai.com/library/research?library=hono&ecosystem=npm&goal=enable+CORS");
console.log(await res.json());
```

## 3. Or as an MCP tool

```ts
// MCP server: https://aayatai.com/mcp (Streamable HTTP). With the x402 MCP client (see /start):
const result = await client.callTool("library-research", {"library":"hono","ecosystem":"npm","goal":"enable CORS"});
```

## Inputs

- `library` **(required)** (string): Package name, e.g. hono, fastapi, tokio.
- `ecosystem` (string; one of `npm`, `pypi`, `crates`, `go`; default `npm`): Package ecosystem: npm, pypi, crates (Rust) or go (Go modules).
- `goal` (string): What you want to do with it, e.g. stream server-sent events (default: overview).

Bad inputs are rejected with HTTP 400 before any payment is asked for.

## Example answer

```json
{
  "library": "hono",
  "ecosystem": "npm",
  "goal": "enable CORS",
  "version": "4.13.9",
  "report": "## Summary\nHono 4.13.9 is a small web framework ... safe to adopt [1].\n\n## How to do the goal\n```ts\napp.use('/api/*', cors())\n```\n[1]\n\n## Gotchas\n- ... [2]",
  "sources": [
    {
      "n": 1,
      "kind": "docs",
      "title": "docs-page",
      "url": "https://hono.dev/docs/middleware/builtin/cors"
    },
    {
      "n": 2,
      "kind": "stackoverflow",
      "title": "Hono CORS not working with credentials",
      "url": "https://stackoverflow.com/q/1"
    }
  ],
  "safety": {
    "verdict": "ok",
    "score": 100,
    "flags": [],
    "licences": [
      "MIT"
    ]
  },
  "repository": {
    "url": "https://github.com/honojs/hono",
    "verdict": "healthy",
    "stars": 32361,
    "lastPushAt": "2026-09-27T03:11:53Z"
  },
  "docs": {
    "sources": [
      {
        "url": "https://hono.dev/docs/middleware/builtin/cors",
        "kind": "docs-page"
      }
    ],
    "tokens": 1500
  },
  "researchedAt": "2026-09-28T12:00:00.000Z"
}
```

## Related

- [GET /docs/find](/services/docs-find) ($0.003): Find the AI-ready docs for any library or API: checks the project's docs site (from its npm, PyPI, crates or Go metadata) or any company domain (docs., develope
- [GET /docs/lib](/services/docs-lib) ($0.005): Up-to-date docs for any npm, PyPI, crates or Go library, trimmed for a coding agent's context: finds the project's own llms.txt and docs pages (or the latest re
- [POST /docs/answer](/services/docs-answer) ($0.02): Ask a coding question about any npm, PyPI, crates or Go library and get an answer written only from its current docs (project llms.txt, docs pages or latest REA
- [GET /openapi](/services/openapi) ($0.005): Understand any public API fast: give its OpenAPI/Swagger spec URL, its docs or base URL, or a name from the APIs.guru directory (?api=stripe.com); we find the s
- [GET /package/check](/services/package-check) ($0.005): Should a coding agent install this package?
- [GET /dependency/verdict](/services/dependency-verdict) ($0.03): "Should I use this dependency?" in one call for npm, PyPI, crates or Go: full package safety check (vulnerabilities, malware, typosquats, deprecation, licence, 
- [GET /dependency/report](/services/dependency-report) ($0.08): Premium "should I use this dependency?" report: package safety (vulnerabilities, malware, typosquats, deprecation), GitHub repository health, licence compatibil
- [GET /package/changes](/services/package-changes) ($0.005): What changed between two versions of an npm, PyPI, crates or Go package: every release's notes from GitHub releases (or the CHANGELOG), newest first, with lines

New here? [Getting started in 60 seconds](/start). All services: [Aayat AI](/).