@axiomworks/agentreader-mcp 0.0.0-stage → 1.6.1

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 AgentReader
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,163 @@
-# Temporary Holding Version
+# @axiomworks/agentreader-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Axiom Works AgentReader** — stdio [MCP](https://modelcontextprotocol.io) server for AI agents.
+
+> Not affiliated with other products named “AgentReader”. This is **Axiom Works AgentReader** at [api.axiomworks.co.uk](https://api.axiomworks.co.uk).
+
+26 pay-per-call tools: web → Markdown, UK Companies House & Charity Commission due diligence, Land Registry / area profiles, document conversion, change monitors, EVM wallet/tx/token/ENS/gas/NFT lookups, ECB FX, and open research search.
+
+Payments use **[x402](https://x402.org) v2 exact** — **USDC on Base** (`eip155:8453`). No API keys or accounts.
+
+- **API:** https://api.axiomworks.co.uk  
+- **Remote MCP (streamable HTTP):** https://api.axiomworks.co.uk/mcp  
+- **Dashboard:** https://api.axiomworks.co.uk/dashboard  
+- **Landing:** https://grokbot1233.github.io/agentreader/  
+- **Repo:** https://github.com/grokbot1233/agentreader  
+- **Typed JS/TS SDK:** [`@axiomworks/agentreader`](https://www.npmjs.com/package/@axiomworks/agentreader)
+
+## Quick start
+
+```bash
+npx -y @axiomworks/agentreader-mcp
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "agentreader": {
+      "command": "npx",
+      "args": ["-y", "@axiomworks/agentreader-mcp"],
+      "env": {
+        "AGENTREADER_PRIVATE_KEY": "0xYOUR_BASE_USDC_PAYER_KEY"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to MCP settings (`.cursor/mcp.json` or Cursor Settings → MCP):
+
+```json
+{
+  "mcpServers": {
+    "agentreader": {
+      "command": "npx",
+      "args": ["-y", "@axiomworks/agentreader-mcp"],
+      "env": {
+        "AGENTREADER_PRIVATE_KEY": "0xYOUR_BASE_USDC_PAYER_KEY"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```json
+{
+  "mcpServers": {
+    "agentreader": {
+      "command": "npx",
+      "args": ["-y", "@axiomworks/agentreader-mcp"],
+      "env": {
+        "AGENTREADER_PRIVATE_KEY": "0xYOUR_BASE_USDC_PAYER_KEY"
+      }
+    }
+  }
+}
+```
+
+Omit `AGENTREADER_PRIVATE_KEY` to explore free **preview** responses (truncated, 8/IP/day) and the free `pricing` tool. Paid calls without a key return a clear `payment_required` payload with x402 requirements.
+
+Alternative env names: `EVM_PRIVATE_KEY`, `PRIVATE_KEY`, `X402_PRIVATE_KEY`.
+
+Override API origin (advanced): `AGENTREADER_ORIGIN=https://api.axiomworks.co.uk`.
+
+### Remote HTTP MCP (no npm)
+
+Clients that speak streamable HTTP can use the hosted server directly:
+
+```json
+{
+  "mcpServers": {
+    "agentreader": {
+      "url": "https://api.axiomworks.co.uk/mcp"
+    }
+  }
+}
+```
+
+(Configure an x402-capable MCP client / wallet for paid tools.)
+
+## How payment works (x402)
+
+1. Tool call hits a paid HTTP route on `api.axiomworks.co.uk`.
+2. Server responds **HTTP 402** with a `PAYMENT-REQUIRED` header (x402 v2).
+3. With `AGENTREADER_PRIVATE_KEY` set, this package uses [`@x402/fetch`](https://www.npmjs.com/package/@x402/fetch) + [`@x402/evm`](https://www.npmjs.com/package/@x402/evm) `ExactEvmScheme` to sign an EIP-3009 USDC transfer on **Base** and retry.
+4. Facilitator settles; you get the JSON result. **No ETH gas needed** for the payer (EIP-3009).
+
+Network: `eip155:8453` · Asset: USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
+
+Fund a Base wallet with a few dollars of USDC for testing. Keep the key offline; never commit it.
+
+Without a key, GET tools automatically add `preview=1` so you still see truncated samples.
+
+## Tools & prices (USDC)
+
+| MCP tool | HTTP | Price | Returns |
+|---|---|---|---|
+| `read_url` | `/read?url=` | $0.002 | Clean Markdown + metadata |
+| `extract_links` | `/links?url=` | $0.001 | De-duplicated absolute links |
+| `check_domain` | `/check?domain=` | $0.001 | DNS/TLS/MX/SPF/DMARC + score |
+| `company_research` | `/company?domain=` | $0.25 | Website company research (sourced) |
+| `uk_company` | `/uk-company?number=` / `name=` | $0.50 | Full UK Companies House DD + red flags |
+| `uk_company_lite` | `/uk-company-lite?...` | $0.05 | UK company snapshot |
+| `company_full` | `/company-full?domain=` | $0.65 | Website research + UK DD when detected |
+| `uk_charity` | `/uk-charity?...` | $0.05 | Charity Commission snapshot |
+| `uk_charity_full` | `/uk-charity-full?...` | $0.25 | Full charity DD + red flags |
+| `convert_document` | `/convert?url=` | $0.03 | PDF/DOCX/HTML → markdown/text |
+| `create_monitor` | `POST /monitor` | $1.00 / 30d | Hourly change → webhook |
+| `wallet_balances` | `/wallet` | $0.003 | EVM balances (5 chains) |
+| `tx_status` | `/tx` | $0.003 | Tx status + decoded transfers |
+| `token_check` | `/token-check` | $0.01 | ERC20 risk score |
+| `fx_rates` | `/fx` | $0.002 | ECB FX + conversion |
+| `ens_lookup` | `/ens` | $0.002 | ENS forward/reverse |
+| `token_metadata` | `/token` | $0.001 | name/symbol/decimals/supply |
+| `token_allowance` | `/allowance` | $0.002 | ERC20 allowance |
+| `contract_info` | `/contract` | $0.003 | Proxy/clone/7702/standards |
+| `gas_fees` | `/gas` | $0.001 | Live gas + USD estimates |
+| `block_lookup` | `/block` | $0.001 | Block by number/time |
+| `nft_lookup` | `/nft` | $0.002 | NFT owner + metadata |
+| `web_search` | `/search?q=` | $0.003 | Wikipedia+OpenAlex+arXiv+Crossref |
+| `uk_property_prices` | `/uk-property` | $0.01 | HM Land Registry near postcode |
+| `uk_area_profile` | `/uk-area` | $0.005 | ONS + police + FSA hygiene |
+| `pricing` | `/.well-known/x402` | **free** | Catalog + payment details |
+
+Free discovery also: [`/llms.txt`](https://api.axiomworks.co.uk/llms.txt) · [`/openapi.json`](https://api.axiomworks.co.uk/openapi.json) · [`/samples/:kind`](https://api.axiomworks.co.uk/samples/company) · `/health`
+
+## Install
+
+```bash
+npm i -g @axiomworks/agentreader-mcp
+agentreader-mcp
+```
+
+Or pin in a project:
+
+```bash
+npm i @axiomworks/agentreader-mcp
+```
+
+## Links
+
+- npm SDK: https://www.npmjs.com/package/@axiomworks/agentreader  
+- Glama listing: https://glama.ai/mcp/servers/grokbot1233/agentreader  
+- Contact: info@axiomworks.co.uk  
+
+MIT © Axiom Works

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,376 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/tools.ts
+import { z } from "zod";
+var ORIGIN = process.env.AGENTREADER_ORIGIN || "https://api.axiomworks.co.uk";
+var VERSION = "1.6.1";
+var CH = z.enum(["base", "ethereum", "arbitrum", "optimism", "polygon"]).optional();
+var qs = (a) => new URLSearchParams(
+  Object.entries(a).filter(([, v]) => v != null && v !== "").map(([k, v]) => [k, String(v)])
+).toString();
+var TOOLS = [
+  {
+    name: "read_url",
+    description: "Use this when you need clean Markdown + metadata from a public URL (not raw HTML). $0.002 USDC on Base via x402.",
+    price: "$0.002",
+    schema: { url: z.string().url() },
+    http: (a) => `${ORIGIN}/read?url=${encodeURIComponent(a.url)}`,
+    previewable: true
+  },
+  {
+    name: "extract_links",
+    description: "Use this when you only need de-duplicated absolute links. $0.001 USDC.",
+    price: "$0.001",
+    schema: { url: z.string().url() },
+    http: (a) => `${ORIGIN}/links?url=${encodeURIComponent(a.url)}`,
+    previewable: true
+  },
+  {
+    name: "check_domain",
+    description: "Use this when vetting domain health: DNS/TLS/MX/SPF/DMARC + score. $0.001 USDC.",
+    price: "$0.001",
+    schema: { domain: z.string() },
+    http: (a) => `${ORIGIN}/check?domain=${encodeURIComponent(a.domain)}`,
+    previewable: true
+  },
+  {
+    name: "company_research",
+    description: "Website company research (tech, contacts, DNS, RDAP, news) with sources \u2014 not UK Companies House. $0.25 USDC.",
+    price: "$0.25",
+    schema: { domain: z.string() },
+    http: (a) => `${ORIGIN}/company?domain=${encodeURIComponent(a.domain)}`,
+    previewable: true
+  },
+  {
+    name: "uk_company",
+    description: "Full UK Companies House due diligence (number or name) + red flags. $0.50 USDC. Prefer uk_company_lite for a cheap snapshot.",
+    price: "$0.50",
+    schema: { number: z.string().optional(), name: z.string().optional() },
+    http: (a) => a.number ? `${ORIGIN}/uk-company?number=${encodeURIComponent(a.number)}` : `${ORIGIN}/uk-company?name=${encodeURIComponent(a.name || "")}`,
+    previewable: true
+  },
+  {
+    name: "uk_company_lite",
+    description: "Cheap UK company snapshot: status, compliance, red flags. $0.05 USDC.",
+    price: "$0.05",
+    schema: { number: z.string().optional(), name: z.string().optional() },
+    http: (a) => a.number ? `${ORIGIN}/uk-company-lite?number=${encodeURIComponent(a.number)}` : `${ORIGIN}/uk-company-lite?name=${encodeURIComponent(a.name || "")}`,
+    previewable: true
+  },
+  {
+    name: "company_full",
+    description: "Website company research + UK CH pack when detected ($0.65 vs $0.75 separate).",
+    price: "$0.65",
+    schema: { domain: z.string() },
+    http: (a) => `${ORIGIN}/company-full?domain=${encodeURIComponent(a.domain)}`,
+    previewable: true
+  },
+  {
+    name: "convert_document",
+    description: "Convert public PDF/DOCX/HTML/text URL to markdown or text. $0.03 USDC.",
+    price: "$0.03",
+    schema: { url: z.string().url(), format: z.enum(["markdown", "text"]).optional() },
+    http: (a) => `${ORIGIN}/convert?url=${encodeURIComponent(a.url)}&format=${encodeURIComponent(a.format || "markdown")}`,
+    previewable: true
+  },
+  {
+    name: "create_monitor",
+    description: "30-day hourly web change monitor \u2192 webhook. $1.00 USDC. POST body.",
+    price: "$1.00",
+    schema: {
+      url: z.string().url(),
+      webhook: z.string().url(),
+      selector: z.string().optional(),
+      keyword: z.string().optional()
+    },
+    http: () => `${ORIGIN}/monitor`,
+    method: "POST",
+    body: (a) => a
+  },
+  {
+    name: "pricing",
+    description: "Free: list Axiom Works AgentReader tools, prices and payment details.",
+    price: "free",
+    schema: {},
+    http: () => `${ORIGIN}/.well-known/x402`,
+    free: true
+  },
+  {
+    name: "wallet_balances",
+    description: "EVM wallet balances (native + majors), 5 chains. $0.003 USDC.",
+    price: "$0.003",
+    schema: { address: z.string(), chain: CH, tokens: z.string().optional() },
+    http: (a) => `${ORIGIN}/wallet?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "tx_status",
+    description: "Did a tx/payment land: status, confirmations, fee, decoded ERC20 transfers. $0.003 USDC.",
+    price: "$0.003",
+    schema: { hash: z.string(), chain: CH },
+    http: (a) => `${ORIGIN}/tx?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "token_check",
+    description: "ERC20 token risk: owner, proxy, liquidity, flags, score. $0.01 USDC.",
+    price: "$0.01",
+    schema: { address: z.string(), chain: CH },
+    http: (a) => `${ORIGIN}/token-check?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "fx_rates",
+    description: "ECB FX rates, latest/historical, with conversion. $0.002 USDC.",
+    price: "$0.002",
+    schema: {
+      base: z.string().optional(),
+      symbols: z.string().optional(),
+      date: z.string().optional(),
+      amount: z.string().optional()
+    },
+    http: (a) => `${ORIGIN}/fx?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "ens_lookup",
+    description: "ENS name -> address + records, or reverse. $0.002 USDC.",
+    price: "$0.002",
+    schema: { name: z.string().optional(), address: z.string().optional() },
+    http: (a) => `${ORIGIN}/ens?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "token_metadata",
+    description: "ERC20 name/symbol/decimals/supply. $0.001 USDC.",
+    price: "$0.001",
+    schema: { address: z.string(), chain: CH },
+    http: (a) => `${ORIGIN}/token?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "token_allowance",
+    description: "ERC20 allowance owner->spender, unlimited flag. $0.002 USDC.",
+    price: "$0.002",
+    schema: { token: z.string(), owner: z.string(), spender: z.string(), chain: CH },
+    http: (a) => `${ORIGIN}/allowance?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "contract_info",
+    description: "Contract/proxy/clone/7702/standards/Sourcify name. $0.003 USDC.",
+    price: "$0.003",
+    schema: { address: z.string(), chain: CH },
+    http: (a) => `${ORIGIN}/contract?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "gas_fees",
+    description: "Current gas fees + USD cost estimates. $0.001 USDC.",
+    price: "$0.001",
+    schema: { chain: CH },
+    http: (a) => `${ORIGIN}/gas?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "block_lookup",
+    description: "Block by number or timestamp. $0.001 USDC.",
+    price: "$0.001",
+    schema: { number: z.string().optional(), timestamp: z.string().optional(), chain: CH },
+    http: (a) => `${ORIGIN}/block?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "nft_lookup",
+    description: "NFT owner + metadata. $0.002 USDC.",
+    price: "$0.002",
+    schema: { contract: z.string(), token_id: z.string(), chain: CH },
+    http: (a) => `${ORIGIN}/nft?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "web_search",
+    description: "Open research search: Wikipedia + OpenAlex + arXiv + Crossref merged, deduped, ranked with snippets. $0.003 USDC.",
+    price: "$0.003",
+    schema: { q: z.string(), sources: z.string().optional(), limit: z.string().optional() },
+    http: (a) => `${ORIGIN}/search?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "uk_property_prices",
+    description: "England & Wales Land Registry sold prices near a postcode + medians. $0.01 USDC.",
+    price: "$0.01",
+    schema: { postcode: z.string(), radius: z.string().optional() },
+    http: (a) => `${ORIGIN}/uk-property?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "uk_area_profile",
+    description: "UK postcode profile: ONS geography, police crime, FSA hygiene. $0.005 USDC.",
+    price: "$0.005",
+    schema: { postcode: z.string() },
+    http: (a) => `${ORIGIN}/uk-area?${qs(a)}`,
+    previewable: true
+  },
+  {
+    name: "uk_charity",
+    description: "UK Charity Commission snapshot: status, income, trustees count, activities. $0.05 USDC.",
+    price: "$0.05",
+    schema: {
+      number: z.string().optional(),
+      name: z.string().optional(),
+      suffix: z.string().optional()
+    },
+    http: (a) => a.number ? `${ORIGIN}/uk-charity?number=${encodeURIComponent(a.number)}${a.suffix != null ? `&suffix=${encodeURIComponent(a.suffix)}` : ""}` : `${ORIGIN}/uk-charity?name=${encodeURIComponent(a.name || "")}`,
+    previewable: true
+  },
+  {
+    name: "uk_charity_full",
+    description: "Full UK charity DD: trustees, finances, assets, governance, regulatory + red flags. $0.25 USDC.",
+    price: "$0.25",
+    schema: {
+      number: z.string().optional(),
+      name: z.string().optional(),
+      suffix: z.string().optional()
+    },
+    http: (a) => a.number ? `${ORIGIN}/uk-charity-full?number=${encodeURIComponent(a.number)}${a.suffix != null ? `&suffix=${encodeURIComponent(a.suffix)}` : ""}` : `${ORIGIN}/uk-charity-full?name=${encodeURIComponent(a.name || "")}`,
+    previewable: true
+  }
+];
+
+// src/payment.ts
+import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
+import { ExactEvmScheme } from "@x402/evm/exact/client";
+import { privateKeyToAccount } from "viem/accounts";
+function resolvePrivateKey() {
+  const raw = process.env.AGENTREADER_PRIVATE_KEY || process.env.EVM_PRIVATE_KEY || process.env.PRIVATE_KEY || process.env.X402_PRIVATE_KEY;
+  if (!raw) return void 0;
+  const key = raw.startsWith("0x") ? raw : `0x${raw}`;
+  if (!/^0x[0-9a-fA-F]{64}$/.test(key)) {
+    throw new Error(
+      "Invalid AGENTREADER_PRIVATE_KEY / EVM_PRIVATE_KEY (expected 32-byte hex with optional 0x)"
+    );
+  }
+  return key;
+}
+function createFetch() {
+  const key = resolvePrivateKey();
+  if (!key) return { fetch: globalThis.fetch.bind(globalThis), paying: false };
+  const account = privateKeyToAccount(key);
+  const client = new x402Client().register("eip155:8453", new ExactEvmScheme(account));
+  return { fetch: wrapFetchWithPayment(globalThis.fetch.bind(globalThis), client), paying: true };
+}
+
+// src/index.ts
+function b64json(header) {
+  if (!header) return null;
+  try {
+    return JSON.parse(Buffer.from(header, "base64").toString("utf8"));
+  } catch {
+    return { raw: header.slice(0, 200) };
+  }
+}
+function withPreview(url, tool, paying, args) {
+  if (paying || tool.free || tool.method === "POST" || !tool.previewable) return url;
+  if (args?.preview === false || args?.preview === "0") return url;
+  const u = new URL(url);
+  if (!u.searchParams.has("preview")) u.searchParams.set("preview", "1");
+  return u.toString();
+}
+async function callHttp(tool, args, fetchFn, paying) {
+  let url = tool.http(args || {});
+  url = withPreview(url, tool, paying, args || {});
+  const init = {
+    method: tool.method || "GET",
+    headers: {
+      accept: "application/json",
+      "user-agent": `axiomworks-agentreader-mcp/${VERSION}`
+    }
+  };
+  if (tool.method === "POST") {
+    init.headers["content-type"] = "application/json";
+    init.body = JSON.stringify(tool.body ? tool.body(args) : args);
+  }
+  const res = await fetchFn(url, init);
+  const pr = res.headers.get("payment-required") || res.headers.get("PAYMENT-REQUIRED");
+  const text = await res.text();
+  let body;
+  try {
+    body = JSON.parse(text);
+  } catch {
+    body = { raw: text.slice(0, 2e3) };
+  }
+  if (res.status === 402 || pr) {
+    const payment = b64json(pr);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(
+            {
+              error: "payment_required",
+              status: 402,
+              message: "This tool is paid via x402 (USDC on Base). Set AGENTREADER_PRIVATE_KEY (or EVM_PRIVATE_KEY) so this MCP server can auto-pay, or retry the HTTP URL with @x402/fetch / @axiomworks/agentreader.",
+              paid_http: url.replace(/([?&])preview=1(&|$)/, "$1").replace(/\?$/, ""),
+              mcp: `${ORIGIN}/mcp`,
+              preview_hint: "Without a key, GET tools are called with preview=1 (free truncated sample, 8/IP/day).",
+              payment_required: payment,
+              body
+            },
+            null,
+            2
+          )
+        }
+      ]
+    };
+  }
+  if (!res.ok) {
+    return {
+      isError: true,
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(
+            { error: body?.error || `HTTP ${res.status}`, status: res.status, body },
+            null,
+            2
+          )
+        }
+      ]
+    };
+  }
+  return {
+    content: [{ type: "text", text: typeof body === "string" ? body : JSON.stringify(body) }]
+  };
+}
+async function main() {
+  const { fetch: fetchFn, paying } = createFetch();
+  const server = new McpServer({
+    name: "agentreader",
+    title: "Axiom Works AgentReader",
+    version: VERSION
+  });
+  for (const t of TOOLS) {
+    server.tool(t.name, t.description, t.schema, async (args) => {
+      try {
+        return await callHttp(t, args || {}, fetchFn, paying);
+      } catch (e) {
+        return {
+          isError: true,
+          content: [{ type: "text", text: String(e?.message || e) }]
+        };
+      }
+    });
+  }
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/tools.ts","../src/payment.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * @axiomworks/agentreader-mcp\n * Stdio MCP server for Axiom Works AgentReader.\n * Proxies tool calls to https://api.axiomworks.co.uk (same surface as /mcp).\n * Optional AGENTREADER_PRIVATE_KEY / EVM_PRIVATE_KEY enables auto x402 payment (USDC on Base).\n * Without a key, free previews (&preview=1) still work; paid calls return payment requirements.\n */\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { TOOLS, VERSION, ORIGIN, type ToolDef } from \"./tools.js\";\nimport { createFetch } from \"./payment.js\";\n\nfunction b64json(header: string | null) {\n  if (!header) return null;\n  try {\n    return JSON.parse(Buffer.from(header, \"base64\").toString(\"utf8\"));\n  } catch {\n    return { raw: header.slice(0, 200) };\n  }\n}\n\nfunction withPreview(url: string, tool: ToolDef, paying: boolean, args: Record<string, any>): string {\n  if (paying || tool.free || tool.method === \"POST\" || !tool.previewable) return url;\n  // Explicit preview:false disables free truncated mode\n  if (args?.preview === false || args?.preview === \"0\") return url;\n  const u = new URL(url);\n  if (!u.searchParams.has(\"preview\")) u.searchParams.set(\"preview\", \"1\");\n  return u.toString();\n}\n\nasync function callHttp(\n  tool: ToolDef,\n  args: Record<string, any>,\n  fetchFn: typeof fetch,\n  paying: boolean,\n) {\n  let url = tool.http(args || {});\n  url = withPreview(url, tool, paying, args || {});\n  const init: RequestInit = {\n    method: tool.method || \"GET\",\n    headers: {\n      accept: \"application/json\",\n      \"user-agent\": `axiomworks-agentreader-mcp/${VERSION}`,\n    },\n  };\n  if (tool.method === \"POST\") {\n    (init.headers as Record<string, string>)[\"content-type\"] = \"application/json\";\n    init.body = JSON.stringify(tool.body ? tool.body(args) : args);\n  }\n  const res = await fetchFn(url, init);\n  const pr = res.headers.get(\"payment-required\") || res.headers.get(\"PAYMENT-REQUIRED\");\n  const text = await res.text();\n  let body: any;\n  try {\n    body = JSON.parse(text);\n  } catch {\n    body = { raw: text.slice(0, 2000) };\n  }\n\n  if (res.status === 402 || pr) {\n    const payment = b64json(pr);\n    return {\n      content: [\n        {\n          type: \"text\" as const,\n          text: JSON.stringify(\n            {\n              error: \"payment_required\",\n              status: 402,\n              message:\n                \"This tool is paid via x402 (USDC on Base). Set AGENTREADER_PRIVATE_KEY (or EVM_PRIVATE_KEY) so this MCP server can auto-pay, or retry the HTTP URL with @x402/fetch / @axiomworks/agentreader.\",\n              paid_http: url.replace(/([?&])preview=1(&|$)/, \"$1\").replace(/\\?$/, \"\"),\n              mcp: `${ORIGIN}/mcp`,\n              preview_hint:\n                \"Without a key, GET tools are called with preview=1 (free truncated sample, 8/IP/day).\",\n              payment_required: payment,\n              body,\n            },\n            null,\n            2,\n          ),\n        },\n      ],\n    };\n  }\n  if (!res.ok) {\n    return {\n      isError: true,\n      content: [\n        {\n          type: \"text\" as const,\n          text: JSON.stringify(\n            { error: body?.error || `HTTP ${res.status}`, status: res.status, body },\n            null,\n            2,\n          ),\n        },\n      ],\n    };\n  }\n  return {\n    content: [{ type: \"text\" as const, text: typeof body === \"string\" ? body : JSON.stringify(body) }],\n  };\n}\n\nasync function main() {\n  const { fetch: fetchFn, paying } = createFetch();\n  const server = new McpServer({\n    name: \"agentreader\",\n    title: \"Axiom Works AgentReader\",\n    version: VERSION,\n  });\n\n  for (const t of TOOLS) {\n    server.tool(t.name, t.description, t.schema, async (args) => {\n      try {\n        return await callHttp(t, (args as Record<string, any>) || {}, fetchFn, paying);\n      } catch (e: any) {\n        return {\n          isError: true,\n          content: [{ type: \"text\" as const, text: String(e?.message || e) }],\n        };\n      }\n    });\n  }\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n\nmain().catch((e) => {\n  console.error(e);\n  process.exit(1);\n});\n","import { z } from \"zod\";\n\nexport const ORIGIN = process.env.AGENTREADER_ORIGIN || \"https://api.axiomworks.co.uk\";\nexport const VERSION = \"1.6.1\";\n\nconst CH = z.enum([\"base\", \"ethereum\", \"arbitrum\", \"optimism\", \"polygon\"]).optional();\nconst qs = (a: Record<string, unknown>) =>\n  new URLSearchParams(\n    Object.entries(a)\n      .filter(([, v]) => v != null && v !== \"\")\n      .map(([k, v]) => [k, String(v)]),\n  ).toString();\n\nexport type ToolDef = {\n  name: string;\n  description: string;\n  price: string;\n  schema: Record<string, z.ZodTypeAny>;\n  http: (a: Record<string, any>) => string;\n  method?: \"GET\" | \"POST\";\n  body?: (a: Record<string, any>) => unknown;\n  free?: boolean;\n  /** When true, unpaid preview mode appends preview=1 */\n  previewable?: boolean;\n};\n\nexport const TOOLS: ToolDef[] = [\n  {\n    name: \"read_url\",\n    description:\n      \"Use this when you need clean Markdown + metadata from a public URL (not raw HTML). $0.002 USDC on Base via x402.\",\n    price: \"$0.002\",\n    schema: { url: z.string().url() },\n    http: (a) => `${ORIGIN}/read?url=${encodeURIComponent(a.url)}`,\n    previewable: true,\n  },\n  {\n    name: \"extract_links\",\n    description: \"Use this when you only need de-duplicated absolute links. $0.001 USDC.\",\n    price: \"$0.001\",\n    schema: { url: z.string().url() },\n    http: (a) => `${ORIGIN}/links?url=${encodeURIComponent(a.url)}`,\n    previewable: true,\n  },\n  {\n    name: \"check_domain\",\n    description: \"Use this when vetting domain health: DNS/TLS/MX/SPF/DMARC + score. $0.001 USDC.\",\n    price: \"$0.001\",\n    schema: { domain: z.string() },\n    http: (a) => `${ORIGIN}/check?domain=${encodeURIComponent(a.domain)}`,\n    previewable: true,\n  },\n  {\n    name: \"company_research\",\n    description:\n      \"Website company research (tech, contacts, DNS, RDAP, news) with sources — not UK Companies House. $0.25 USDC.\",\n    price: \"$0.25\",\n    schema: { domain: z.string() },\n    http: (a) => `${ORIGIN}/company?domain=${encodeURIComponent(a.domain)}`,\n    previewable: true,\n  },\n  {\n    name: \"uk_company\",\n    description:\n      \"Full UK Companies House due diligence (number or name) + red flags. $0.50 USDC. Prefer uk_company_lite for a cheap snapshot.\",\n    price: \"$0.50\",\n    schema: { number: z.string().optional(), name: z.string().optional() },\n    http: (a) =>\n      a.number\n        ? `${ORIGIN}/uk-company?number=${encodeURIComponent(a.number)}`\n        : `${ORIGIN}/uk-company?name=${encodeURIComponent(a.name || \"\")}`,\n    previewable: true,\n  },\n  {\n    name: \"uk_company_lite\",\n    description: \"Cheap UK company snapshot: status, compliance, red flags. $0.05 USDC.\",\n    price: \"$0.05\",\n    schema: { number: z.string().optional(), name: z.string().optional() },\n    http: (a) =>\n      a.number\n        ? `${ORIGIN}/uk-company-lite?number=${encodeURIComponent(a.number)}`\n        : `${ORIGIN}/uk-company-lite?name=${encodeURIComponent(a.name || \"\")}`,\n    previewable: true,\n  },\n  {\n    name: \"company_full\",\n    description: \"Website company research + UK CH pack when detected ($0.65 vs $0.75 separate).\",\n    price: \"$0.65\",\n    schema: { domain: z.string() },\n    http: (a) => `${ORIGIN}/company-full?domain=${encodeURIComponent(a.domain)}`,\n    previewable: true,\n  },\n  {\n    name: \"convert_document\",\n    description: \"Convert public PDF/DOCX/HTML/text URL to markdown or text. $0.03 USDC.\",\n    price: \"$0.03\",\n    schema: { url: z.string().url(), format: z.enum([\"markdown\", \"text\"]).optional() },\n    http: (a) =>\n      `${ORIGIN}/convert?url=${encodeURIComponent(a.url)}&format=${encodeURIComponent(a.format || \"markdown\")}`,\n    previewable: true,\n  },\n  {\n    name: \"create_monitor\",\n    description: \"30-day hourly web change monitor → webhook. $1.00 USDC. POST body.\",\n    price: \"$1.00\",\n    schema: {\n      url: z.string().url(),\n      webhook: z.string().url(),\n      selector: z.string().optional(),\n      keyword: z.string().optional(),\n    },\n    http: () => `${ORIGIN}/monitor`,\n    method: \"POST\",\n    body: (a) => a,\n  },\n  {\n    name: \"pricing\",\n    description: \"Free: list Axiom Works AgentReader tools, prices and payment details.\",\n    price: \"free\",\n    schema: {},\n    http: () => `${ORIGIN}/.well-known/x402`,\n    free: true,\n  },\n  {\n    name: \"wallet_balances\",\n    description: \"EVM wallet balances (native + majors), 5 chains. $0.003 USDC.\",\n    price: \"$0.003\",\n    schema: { address: z.string(), chain: CH, tokens: z.string().optional() },\n    http: (a) => `${ORIGIN}/wallet?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"tx_status\",\n    description: \"Did a tx/payment land: status, confirmations, fee, decoded ERC20 transfers. $0.003 USDC.\",\n    price: \"$0.003\",\n    schema: { hash: z.string(), chain: CH },\n    http: (a) => `${ORIGIN}/tx?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"token_check\",\n    description: \"ERC20 token risk: owner, proxy, liquidity, flags, score. $0.01 USDC.\",\n    price: \"$0.01\",\n    schema: { address: z.string(), chain: CH },\n    http: (a) => `${ORIGIN}/token-check?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"fx_rates\",\n    description: \"ECB FX rates, latest/historical, with conversion. $0.002 USDC.\",\n    price: \"$0.002\",\n    schema: {\n      base: z.string().optional(),\n      symbols: z.string().optional(),\n      date: z.string().optional(),\n      amount: z.string().optional(),\n    },\n    http: (a) => `${ORIGIN}/fx?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"ens_lookup\",\n    description: \"ENS name -> address + records, or reverse. $0.002 USDC.\",\n    price: \"$0.002\",\n    schema: { name: z.string().optional(), address: z.string().optional() },\n    http: (a) => `${ORIGIN}/ens?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"token_metadata\",\n    description: \"ERC20 name/symbol/decimals/supply. $0.001 USDC.\",\n    price: \"$0.001\",\n    schema: { address: z.string(), chain: CH },\n    http: (a) => `${ORIGIN}/token?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"token_allowance\",\n    description: \"ERC20 allowance owner->spender, unlimited flag. $0.002 USDC.\",\n    price: \"$0.002\",\n    schema: { token: z.string(), owner: z.string(), spender: z.string(), chain: CH },\n    http: (a) => `${ORIGIN}/allowance?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"contract_info\",\n    description: \"Contract/proxy/clone/7702/standards/Sourcify name. $0.003 USDC.\",\n    price: \"$0.003\",\n    schema: { address: z.string(), chain: CH },\n    http: (a) => `${ORIGIN}/contract?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"gas_fees\",\n    description: \"Current gas fees + USD cost estimates. $0.001 USDC.\",\n    price: \"$0.001\",\n    schema: { chain: CH },\n    http: (a) => `${ORIGIN}/gas?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"block_lookup\",\n    description: \"Block by number or timestamp. $0.001 USDC.\",\n    price: \"$0.001\",\n    schema: { number: z.string().optional(), timestamp: z.string().optional(), chain: CH },\n    http: (a) => `${ORIGIN}/block?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"nft_lookup\",\n    description: \"NFT owner + metadata. $0.002 USDC.\",\n    price: \"$0.002\",\n    schema: { contract: z.string(), token_id: z.string(), chain: CH },\n    http: (a) => `${ORIGIN}/nft?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"web_search\",\n    description:\n      \"Open research search: Wikipedia + OpenAlex + arXiv + Crossref merged, deduped, ranked with snippets. $0.003 USDC.\",\n    price: \"$0.003\",\n    schema: { q: z.string(), sources: z.string().optional(), limit: z.string().optional() },\n    http: (a) => `${ORIGIN}/search?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"uk_property_prices\",\n    description: \"England & Wales Land Registry sold prices near a postcode + medians. $0.01 USDC.\",\n    price: \"$0.01\",\n    schema: { postcode: z.string(), radius: z.string().optional() },\n    http: (a) => `${ORIGIN}/uk-property?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"uk_area_profile\",\n    description: \"UK postcode profile: ONS geography, police crime, FSA hygiene. $0.005 USDC.\",\n    price: \"$0.005\",\n    schema: { postcode: z.string() },\n    http: (a) => `${ORIGIN}/uk-area?${qs(a)}`,\n    previewable: true,\n  },\n  {\n    name: \"uk_charity\",\n    description:\n      \"UK Charity Commission snapshot: status, income, trustees count, activities. $0.05 USDC.\",\n    price: \"$0.05\",\n    schema: {\n      number: z.string().optional(),\n      name: z.string().optional(),\n      suffix: z.string().optional(),\n    },\n    http: (a) =>\n      a.number\n        ? `${ORIGIN}/uk-charity?number=${encodeURIComponent(a.number)}${a.suffix != null ? `&suffix=${encodeURIComponent(a.suffix)}` : \"\"}`\n        : `${ORIGIN}/uk-charity?name=${encodeURIComponent(a.name || \"\")}`,\n    previewable: true,\n  },\n  {\n    name: \"uk_charity_full\",\n    description:\n      \"Full UK charity DD: trustees, finances, assets, governance, regulatory + red flags. $0.25 USDC.\",\n    price: \"$0.25\",\n    schema: {\n      number: z.string().optional(),\n      name: z.string().optional(),\n      suffix: z.string().optional(),\n    },\n    http: (a) =>\n      a.number\n        ? `${ORIGIN}/uk-charity-full?number=${encodeURIComponent(a.number)}${a.suffix != null ? `&suffix=${encodeURIComponent(a.suffix)}` : \"\"}`\n        : `${ORIGIN}/uk-charity-full?name=${encodeURIComponent(a.name || \"\")}`,\n    previewable: true,\n  },\n];\n","import { wrapFetchWithPayment, x402Client } from \"@x402/fetch\";\nimport { ExactEvmScheme } from \"@x402/evm/exact/client\";\nimport { privateKeyToAccount } from \"viem/accounts\";\n\nexport type PaidFetch = typeof fetch;\n\n/** Resolve an EVM private key from common env names. */\nexport function resolvePrivateKey(): `0x${string}` | undefined {\n  const raw =\n    process.env.AGENTREADER_PRIVATE_KEY ||\n    process.env.EVM_PRIVATE_KEY ||\n    process.env.PRIVATE_KEY ||\n    process.env.X402_PRIVATE_KEY;\n  if (!raw) return undefined;\n  const key = raw.startsWith(\"0x\") ? raw : `0x${raw}`;\n  if (!/^0x[0-9a-fA-F]{64}$/.test(key)) {\n    throw new Error(\n      \"Invalid AGENTREADER_PRIVATE_KEY / EVM_PRIVATE_KEY (expected 32-byte hex with optional 0x)\",\n    );\n  }\n  return key as `0x${string}`;\n}\n\n/** Build a fetch that auto-settles x402 exact USDC on Base when a key is present. */\nexport function createFetch(): { fetch: PaidFetch; paying: boolean } {\n  const key = resolvePrivateKey();\n  if (!key) return { fetch: globalThis.fetch.bind(globalThis), paying: false };\n  const account = privateKeyToAccount(key);\n  const client = new x402Client().register(\"eip155:8453\", new ExactEvmScheme(account));\n  return { fetch: wrapFetchWithPayment(globalThis.fetch.bind(globalThis), client), paying: true };\n}\n"],"mappings":";;;AAQA,SAAS,iBAAiB;AAC1B,SAAS,4BAA4B;;;ACTrC,SAAS,SAAS;AAEX,IAAM,SAAS,QAAQ,IAAI,sBAAsB;AACjD,IAAM,UAAU;AAEvB,IAAM,KAAK,EAAE,KAAK,CAAC,QAAQ,YAAY,YAAY,YAAY,SAAS,CAAC,EAAE,SAAS;AACpF,IAAM,KAAK,CAAC,MACV,IAAI;AAAA,EACF,OAAO,QAAQ,CAAC,EACb,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,QAAQ,MAAM,EAAE,EACvC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;AACnC,EAAE,SAAS;AAeN,IAAM,QAAmB;AAAA,EAC9B;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IACF,OAAO;AAAA,IACP,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;AAAA,IAChC,MAAM,CAAC,MAAM,GAAG,MAAM,aAAa,mBAAmB,EAAE,GAAG,CAAC;AAAA,IAC5D,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;AAAA,IAChC,MAAM,CAAC,MAAM,GAAG,MAAM,cAAc,mBAAmB,EAAE,GAAG,CAAC;AAAA,IAC7D,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE;AAAA,IAC7B,MAAM,CAAC,MAAM,GAAG,MAAM,iBAAiB,mBAAmB,EAAE,MAAM,CAAC;AAAA,IACnE,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IACF,OAAO;AAAA,IACP,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE;AAAA,IAC7B,MAAM,CAAC,MAAM,GAAG,MAAM,mBAAmB,mBAAmB,EAAE,MAAM,CAAC;AAAA,IACrE,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IACF,OAAO;AAAA,IACP,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;AAAA,IACrE,MAAM,CAAC,MACL,EAAE,SACE,GAAG,MAAM,sBAAsB,mBAAmB,EAAE,MAAM,CAAC,KAC3D,GAAG,MAAM,oBAAoB,mBAAmB,EAAE,QAAQ,EAAE,CAAC;AAAA,IACnE,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE;AAAA,IACrE,MAAM,CAAC,MACL,EAAE,SACE,GAAG,MAAM,2BAA2B,mBAAmB,EAAE,MAAM,CAAC,KAChE,GAAG,MAAM,yBAAyB,mBAAmB,EAAE,QAAQ,EAAE,CAAC;AAAA,IACxE,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE;AAAA,IAC7B,MAAM,CAAC,MAAM,GAAG,MAAM,wBAAwB,mBAAmB,EAAE,MAAM,CAAC;AAAA,IAC1E,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,GAAG,QAAQ,EAAE,KAAK,CAAC,YAAY,MAAM,CAAC,EAAE,SAAS,EAAE;AAAA,IACjF,MAAM,CAAC,MACL,GAAG,MAAM,gBAAgB,mBAAmB,EAAE,GAAG,CAAC,WAAW,mBAAmB,EAAE,UAAU,UAAU,CAAC;AAAA,IACzG,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ;AAAA,MACN,KAAK,EAAE,OAAO,EAAE,IAAI;AAAA,MACpB,SAAS,EAAE,OAAO,EAAE,IAAI;AAAA,MACxB,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,MAC9B,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,IAC/B;AAAA,IACA,MAAM,MAAM,GAAG,MAAM;AAAA,IACrB,QAAQ;AAAA,IACR,MAAM,CAAC,MAAM;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,CAAC;AAAA,IACT,MAAM,MAAM,GAAG,MAAM;AAAA,IACrB,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;AAAA,IACxE,MAAM,CAAC,MAAM,GAAG,MAAM,WAAW,GAAG,CAAC,CAAC;AAAA,IACtC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG;AAAA,IACtC,MAAM,CAAC,MAAM,GAAG,MAAM,OAAO,GAAG,CAAC,CAAC;AAAA,IAClC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG;AAAA,IACzC,MAAM,CAAC,MAAM,GAAG,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAAA,IAC3C,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ;AAAA,MACN,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,MAC1B,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,MAC7B,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,MAC1B,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,IAC9B;AAAA,IACA,MAAM,CAAC,MAAM,GAAG,MAAM,OAAO,GAAG,CAAC,CAAC;AAAA,IAClC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE;AAAA,IACtE,MAAM,CAAC,MAAM,GAAG,MAAM,QAAQ,GAAG,CAAC,CAAC;AAAA,IACnC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG;AAAA,IACzC,MAAM,CAAC,MAAM,GAAG,MAAM,UAAU,GAAG,CAAC,CAAC;AAAA,IACrC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG;AAAA,IAC/E,MAAM,CAAC,MAAM,GAAG,MAAM,cAAc,GAAG,CAAC,CAAC;AAAA,IACzC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG;AAAA,IACzC,MAAM,CAAC,MAAM,GAAG,MAAM,aAAa,GAAG,CAAC,CAAC;AAAA,IACxC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,OAAO,GAAG;AAAA,IACpB,MAAM,CAAC,MAAM,GAAG,MAAM,QAAQ,GAAG,CAAC,CAAC;AAAA,IACnC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,GAAG,WAAW,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,GAAG;AAAA,IACrF,MAAM,CAAC,MAAM,GAAG,MAAM,UAAU,GAAG,CAAC,CAAC;AAAA,IACrC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,UAAU,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG;AAAA,IAChE,MAAM,CAAC,MAAM,GAAG,MAAM,QAAQ,GAAG,CAAC,CAAC;AAAA,IACnC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IACF,OAAO;AAAA,IACP,QAAQ,EAAE,GAAG,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE;AAAA,IACtF,MAAM,CAAC,MAAM,GAAG,MAAM,WAAW,GAAG,CAAC,CAAC;AAAA,IACtC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,UAAU,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;AAAA,IAC9D,MAAM,CAAC,MAAM,GAAG,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAAA,IAC3C,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,OAAO;AAAA,IACP,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE;AAAA,IAC/B,MAAM,CAAC,MAAM,GAAG,MAAM,YAAY,GAAG,CAAC,CAAC;AAAA,IACvC,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IACF,OAAO;AAAA,IACP,QAAQ;AAAA,MACN,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,MAC5B,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,MAC1B,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,IAC9B;AAAA,IACA,MAAM,CAAC,MACL,EAAE,SACE,GAAG,MAAM,sBAAsB,mBAAmB,EAAE,MAAM,CAAC,GAAG,EAAE,UAAU,OAAO,WAAW,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,KAC/H,GAAG,MAAM,oBAAoB,mBAAmB,EAAE,QAAQ,EAAE,CAAC;AAAA,IACnE,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IACF,OAAO;AAAA,IACP,QAAQ;AAAA,MACN,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,MAC5B,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,MAC1B,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,IAC9B;AAAA,IACA,MAAM,CAAC,MACL,EAAE,SACE,GAAG,MAAM,2BAA2B,mBAAmB,EAAE,MAAM,CAAC,GAAG,EAAE,UAAU,OAAO,WAAW,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,KACpI,GAAG,MAAM,yBAAyB,mBAAmB,EAAE,QAAQ,EAAE,CAAC;AAAA,IACxE,aAAa;AAAA,EACf;AACF;;;ACjRA,SAAS,sBAAsB,kBAAkB;AACjD,SAAS,sBAAsB;AAC/B,SAAS,2BAA2B;AAK7B,SAAS,oBAA+C;AAC7D,QAAM,MACJ,QAAQ,IAAI,2BACZ,QAAQ,IAAI,mBACZ,QAAQ,IAAI,eACZ,QAAQ,IAAI;AACd,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,MAAM,IAAI,WAAW,IAAI,IAAI,MAAM,KAAK,GAAG;AACjD,MAAI,CAAC,sBAAsB,KAAK,GAAG,GAAG;AACpC,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,cAAqD;AACnE,QAAM,MAAM,kBAAkB;AAC9B,MAAI,CAAC,IAAK,QAAO,EAAE,OAAO,WAAW,MAAM,KAAK,UAAU,GAAG,QAAQ,MAAM;AAC3E,QAAM,UAAU,oBAAoB,GAAG;AACvC,QAAM,SAAS,IAAI,WAAW,EAAE,SAAS,eAAe,IAAI,eAAe,OAAO,CAAC;AACnF,SAAO,EAAE,OAAO,qBAAqB,WAAW,MAAM,KAAK,UAAU,GAAG,MAAM,GAAG,QAAQ,KAAK;AAChG;;;AFjBA,SAAS,QAAQ,QAAuB;AACtC,MAAI,CAAC,OAAQ,QAAO;AACpB,MAAI;AACF,WAAO,KAAK,MAAM,OAAO,KAAK,QAAQ,QAAQ,EAAE,SAAS,MAAM,CAAC;AAAA,EAClE,QAAQ;AACN,WAAO,EAAE,KAAK,OAAO,MAAM,GAAG,GAAG,EAAE;AAAA,EACrC;AACF;AAEA,SAAS,YAAY,KAAa,MAAe,QAAiB,MAAmC;AACnG,MAAI,UAAU,KAAK,QAAQ,KAAK,WAAW,UAAU,CAAC,KAAK,YAAa,QAAO;AAE/E,MAAI,MAAM,YAAY,SAAS,MAAM,YAAY,IAAK,QAAO;AAC7D,QAAM,IAAI,IAAI,IAAI,GAAG;AACrB,MAAI,CAAC,EAAE,aAAa,IAAI,SAAS,EAAG,GAAE,aAAa,IAAI,WAAW,GAAG;AACrE,SAAO,EAAE,SAAS;AACpB;AAEA,eAAe,SACb,MACA,MACA,SACA,QACA;AACA,MAAI,MAAM,KAAK,KAAK,QAAQ,CAAC,CAAC;AAC9B,QAAM,YAAY,KAAK,MAAM,QAAQ,QAAQ,CAAC,CAAC;AAC/C,QAAM,OAAoB;AAAA,IACxB,QAAQ,KAAK,UAAU;AAAA,IACvB,SAAS;AAAA,MACP,QAAQ;AAAA,MACR,cAAc,8BAA8B,OAAO;AAAA,IACrD;AAAA,EACF;AACA,MAAI,KAAK,WAAW,QAAQ;AAC1B,IAAC,KAAK,QAAmC,cAAc,IAAI;AAC3D,SAAK,OAAO,KAAK,UAAU,KAAK,OAAO,KAAK,KAAK,IAAI,IAAI,IAAI;AAAA,EAC/D;AACA,QAAM,MAAM,MAAM,QAAQ,KAAK,IAAI;AACnC,QAAM,KAAK,IAAI,QAAQ,IAAI,kBAAkB,KAAK,IAAI,QAAQ,IAAI,kBAAkB;AACpF,QAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,MAAI;AACJ,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO,EAAE,KAAK,KAAK,MAAM,GAAG,GAAI,EAAE;AAAA,EACpC;AAEA,MAAI,IAAI,WAAW,OAAO,IAAI;AAC5B,UAAM,UAAU,QAAQ,EAAE;AAC1B,WAAO;AAAA,MACL,SAAS;AAAA,QACP;AAAA,UACE,MAAM;AAAA,UACN,MAAM,KAAK;AAAA,YACT;AAAA,cACE,OAAO;AAAA,cACP,QAAQ;AAAA,cACR,SACE;AAAA,cACF,WAAW,IAAI,QAAQ,wBAAwB,IAAI,EAAE,QAAQ,OAAO,EAAE;AAAA,cACtE,KAAK,GAAG,MAAM;AAAA,cACd,cACE;AAAA,cACF,kBAAkB;AAAA,cAClB;AAAA,YACF;AAAA,YACA;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,MAAI,CAAC,IAAI,IAAI;AACX,WAAO;AAAA,MACL,SAAS;AAAA,MACT,SAAS;AAAA,QACP;AAAA,UACE,MAAM;AAAA,UACN,MAAM,KAAK;AAAA,YACT,EAAE,OAAO,MAAM,SAAS,QAAQ,IAAI,MAAM,IAAI,QAAQ,IAAI,QAAQ,KAAK;AAAA,YACvE;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL,SAAS,CAAC,EAAE,MAAM,QAAiB,MAAM,OAAO,SAAS,WAAW,OAAO,KAAK,UAAU,IAAI,EAAE,CAAC;AAAA,EACnG;AACF;AAEA,eAAe,OAAO;AACpB,QAAM,EAAE,OAAO,SAAS,OAAO,IAAI,YAAY;AAC/C,QAAM,SAAS,IAAI,UAAU;AAAA,IAC3B,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SAAS;AAAA,EACX,CAAC;AAED,aAAW,KAAK,OAAO;AACrB,WAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,OAAO,SAAS;AAC3D,UAAI;AACF,eAAO,MAAM,SAAS,GAAI,QAAgC,CAAC,GAAG,SAAS,MAAM;AAAA,MAC/E,SAAS,GAAQ;AACf,eAAO;AAAA,UACL,SAAS;AAAA,UACT,SAAS,CAAC,EAAE,MAAM,QAAiB,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,CAAC;AAAA,QACpE;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,YAAY,IAAI,qBAAqB;AAC3C,QAAM,OAAO,QAAQ,SAAS;AAChC;AAEA,KAAK,EAAE,MAAM,CAAC,MAAM;AAClB,UAAQ,MAAM,CAAC;AACf,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/package.json

@@ -1,6 +1,89 @@
 {
   "name": "@axiomworks/agentreader-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.6.1",
+  "description": "Axiom Works AgentReader stdio MCP server \u2014 26 x402-paid tools (web read, UK Companies House/charity/property, EVM wallet/tx/token/ENS, FX, search). Auto-pays USDC on Base when AGENTREADER_PRIVATE_KEY is set. Run: npx -y @axiomworks/agentreader-mcp",
+  "type": "module",
+  "mcpName": "io.github.grokbot1233/agentreader",
+  "bin": {
+    "agentreader-mcp": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup && node -e \"require('fs').chmodSync('dist/index.js',0o755)\"",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "x402",
+    "ai-agent",
+    "agents",
+    "agentreader",
+    "axiomworks",
+    "axiom-works",
+    "web-scraping",
+    "markdown",
+    "companies-house",
+    "uk-company",
+    "uk-charity",
+    "charity-commission",
+    "due-diligence",
+    "blockchain",
+    "base",
+    "usdc",
+    "crypto",
+    "evm",
+    "ens",
+    "nft",
+    "fx",
+    "langchain",
+    "claude",
+    "cursor",
+    "claude-desktop",
+    "stdio",
+    "pay-per-call"
+  ],
+  "author": "Axiom Works <info@axiomworks.co.uk>",
+  "license": "MIT",
+  "homepage": "https://grokbot1233.github.io/agentreader/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grokbot1233/agentreader.git",
+    "directory": "packages/agentreader-mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/grokbot1233/agentreader/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "@x402/evm": "^2.30.0",
+    "@x402/fetch": "^2.30.0",
+    "viem": "^2.57.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3"
+  },
+  "allowScripts": {
+    "esbuild@0.27.7": true
+  }
+}