netintel-mcp 1.1.56 → 1.1.58

package/README.md

@@ -1,6 +1,6 @@
 # netintel-mcp
 
-MCP server for NetIntel — 122 network intelligence tools for AI agents.
+MCP server for NetIntel — 123 network intelligence tools for AI agents.
 DNS, SSL, WHOIS, email security, cloud fingerprinting, OSINT and more.
 Pay-per-call via x402 — the NetIntel API accepts USDC on Base or Solana; this MCP server pays on Base. No API keys needed — just a wallet with USDC.
 
@@ -38,11 +38,11 @@ Or add manually to your Claude Desktop config:
 
 ## Requirements
 - **Optional:** `EVM_PRIVATE_KEY` — a dedicated agent wallet holding USDC on Base mainnet (gasless; a few dollars is plenty). With it, every tool pays its listed price automatically.
-- **Without a wallet** the server still runs: `netintel_dns_lookup`, `netintel_ssl_cert`, `netintel_whois_lookup`, `netintel_subnet_calc` and `netintel_email_auth` work free (about 30 calls/hour per client, then the normal price), and paid tools reply with what they cost and how to fund. `netintel_wallet_status` shows the wallet, its USDC balance and the free tools. **Spending limits (≥1.1.55):** the server refuses to sign a payment above `NETINTEL_MAX_PER_CALL_USD` (default $0.25) or once it has authorized `NETINTEL_MAX_SESSION_USD` (default $5) in total per process; a refusal returns `SPEND_LIMIT: …` and nothing is paid. Listed prices are what a call costs, not a cap — with a wallet configured every 402 (including a free-tier route past its quota) is paid automatically, so authorize paid calls with your user first.
+- **Without a wallet** the server still runs: every tool replies with what it costs and how to fund, and `netintel_wallet_status` shows the wallet and its USDC balance. **Spending limits (≥1.1.55):** the server refuses to sign a payment above `NETINTEL_MAX_PER_CALL_USD` (default $0.25) or once it has authorized `NETINTEL_MAX_SESSION_USD` (default $5) in total per process; a refusal returns `SPEND_LIMIT: …` and nothing is paid. Listed prices are what a call costs, not a cap — with a wallet configured every 402 is paid automatically, so authorize paid calls with your user first.
 
 ## Tools
 
-122 pay-per-call tools across DNS, SSL/TLS, WHOIS & domains, email security, IP intelligence, web & content, OSINT, AI text processing, and bundled reports.
+123 pay-per-call tools across DNS, SSL/TLS, WHOIS & domains, email security, IP intelligence, web & content, OSINT, AI text processing, and bundled reports.
 
 | Tool | Description | Price |
 |------|-------------|-------|
@@ -168,6 +168,7 @@ Or add manually to your Claude Desktop config:
 | netintel_web_search | Web search for AI agents — one query in, ranked live results out… | $0.01 |
 | netintel_exa_contents | Clean page text for up to 3 URLs in one call via Exa's index + live… | $0.005 |
 | netintel_exa_answer | Ask a question, get a direct answer grounded in a live web search, with… | $0.01 |
+| netintel_pdf_parse | Parse a PDF to text and Markdown: send a PDF url or base64 file, get… | $0.005 |
 
 ## Payment
 All tools pay automatically via x402 in USDC on Base mainnet.

package/dist/client.js

@@ -9,20 +9,20 @@ import axios from "axios";
 const BASE_URL = "https://netintel.dev";
 /** USDC on Base mainnet — the asset every NetIntel price is quoted in. */
 const USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
-/** Tools that work with NO wallet: NetIntel's free tier (per-client quota, then the normal price). */
-export const FREE_TOOLS = [
-    "netintel_dns_lookup",
-    "netintel_ssl_cert",
-    "netintel_whois_lookup",
-    "netintel_subnet_calc",
-    "netintel_email_auth",
-];
+/**
+ * Tools that work with NO wallet. NetIntel's free tier is switched by the API's
+ * FREE_TIER env and has been OFF since 2026-10-08, so every call is paid and this
+ * list is empty. If the API turns it back on, list its tools here again
+ * (netintel_dns_lookup, netintel_ssl_cert, netintel_whois_lookup,
+ * netintel_subnet_calc, netintel_email_auth) — every "works free" message keys off it.
+ */
+export const FREE_TOOLS = [];
 let walletAddress = null;
 /**
  * Spending limits, enforced INSIDE the x402 client immediately before a payment
  * payload is signed — the only place a limit can be real, because with a wallet
- * configured every 402 (including a free-tier route past its quota) is paid
- * automatically. The listed per-call prices are what a route costs, not a cap.
+ * configured every 402 is paid automatically. The listed per-call prices are
+ * what a route costs, not a cap.
  *   NETINTEL_MAX_PER_CALL_USD  — refuse any single payment above this (default $0.25)
  *   NETINTEL_MAX_SESSION_USD   — refuse once this MCP server process has authorized
  *                                this much in total (default $5.00)
@@ -59,16 +59,17 @@ export function configuredWallet() {
 /**
  * The HTTP client every tool uses. With EVM_PRIVATE_KEY set, responses that
  * demand payment are paid automatically (x402) and retried; without it, the
- * server still starts — the free-tier tools work as-is and paid tools return
- * an explanation of what a call costs and how to fund a wallet, instead of
- * failing to boot for everyone who installed the plugin before funding one.
+ * server still starts — tools return an explanation of what a call costs and
+ * how to fund a wallet (and any FREE_TOOLS work as-is), instead of failing to
+ * boot for everyone who installed the plugin before funding one.
  */
 export async function createClient() {
     const key = process.env.EVM_PRIVATE_KEY?.trim();
     const plain = axios.create({ baseURL: BASE_URL });
     if (!key) {
-        console.error("[netintel-mcp] No EVM_PRIVATE_KEY set — running wallet-less. Free-tier tools work " +
-            `(${FREE_TOOLS.join(", ")}); paid tools will explain how to fund an agent wallet.`);
+        console.error("[netintel-mcp] No EVM_PRIVATE_KEY set — running wallet-less. " +
+            (FREE_TOOLS.length ? `Free-tier tools work (${FREE_TOOLS.join(", ")}); ` : "") +
+            "paid tools will explain how to fund an agent wallet.");
         return plain;
     }
     const signer = privateKeyToAccount(key);

package/dist/index.js

@@ -23,7 +23,7 @@ function err(e) {
         const cost = price ? `This tool costs ${price} per call (USDC on Base). ` : "This tool is paid per call (USDC on Base). ";
         const fix = configuredWallet()
             ? `The agent wallet ${configuredWallet()} is configured but the payment did not settle — usually an empty wallet. Run netintel_wallet_status to check its USDC balance, then fund it on Base.`
-            : `No agent wallet is configured, so it cannot be paid. Set EVM_PRIVATE_KEY to a wallet holding USDC on Base (or enter it in the Claude Code plugin config), then retry. Without a wallet these tools still work free, up to a quota: ${FREE_TOOLS.join(", ")}.`;
+            : `No agent wallet is configured, so it cannot be paid. Set EVM_PRIVATE_KEY to a wallet holding USDC on Base (or enter it in the Claude Code plugin config), then retry.${FREE_TOOLS.length ? ` Without a wallet these tools still work free, up to a quota: ${FREE_TOOLS.join(", ")}.` : ""}`;
         return { content: [{ type: "text", text: `Payment required. ${cost}${fix}` }], isError: true };
     }
     return {
@@ -1277,6 +1277,16 @@ function registerTools(server, api) {
             return err(e);
         }
     });
+    // 124. Pdf (POST)
+    server.tool("netintel_pdf_parse", "Parse a PDF to text and Markdown: send a PDF url or base64 file, get clean Markdown with paragraphs rebuilt from the text layer, per-page character offsets for citing pages, metadata (title, author, dates, page count) and the page numbers…", { url: z.string().optional(), file_base64: z.string().optional(), pages: z.string().optional(), max_chars: z.number().optional() }, async ({ url, file_base64, pages, max_chars }) => {
+        try {
+            const res = await api.post("/pdf/parse", { url, file_base64, pages, max_chars });
+            return ok(res.data);
+        }
+        catch (e) {
+            return err(e);
+        }
+    });
 }
 // Wallet status — free, local: lets an agent (or a human) tell "no wallet",
 // "empty wallet" and "funded" apart before spending a call on finding out.
@@ -1284,9 +1294,11 @@ function registerTools(server, api) {
 // server.tool() in there with the api.get/post path that follows it, and this
 // tool makes no API call.
 function registerWalletTool(server) {
-    server.tool("netintel_wallet_status", "Check the agent wallet this MCP server pays NetIntel with: whether a key is configured, its address, its USDC balance on Base, and the spending limits (per call and per session) with how much this session has authorized. Free and local (no NetIntel call). Use when a paid tool reports 'Payment required' or 'SPEND_LIMIT', before funding, or to confirm a top-up arrived. Also lists the tools that work with no wallet at all.", {}, async () => {
+    server.tool("netintel_wallet_status", `Check the agent wallet this MCP server pays NetIntel with: whether a key is configured, its address, its USDC balance on Base, and the spending limits (per call and per session) with how much this session has authorized. Free and local (no NetIntel call). Use when a paid tool reports 'Payment required' or 'SPEND_LIMIT', before funding, or to confirm a top-up arrived.${FREE_TOOLS.length ? " Also lists the tools that work with no wallet at all." : ""}`, {}, async () => {
         const address = configuredWallet();
-        const free = { free_without_wallet: [...FREE_TOOLS], note: "Free tools are rate-limited per client (about 30/hour); over the quota they cost their normal price." };
+        const free = FREE_TOOLS.length
+            ? { free_without_wallet: [...FREE_TOOLS], note: "Free tools are rate-limited per client (about 30/hour); over the quota they cost their normal price." }
+            : {};
         if (!address) {
             return ok({ wallet_configured: false, how_to_fund: "Set EVM_PRIVATE_KEY (or the plugin's wallet config) to a dedicated agent wallet, then send it a few dollars of USDC on Base mainnet — no ETH needed, settlement is gasless.", ...free });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "netintel-mcp",
-  "version": "1.1.56",
+  "version": "1.1.58",
   "mcpName": "io.github.kjgueye/netintel-mcp",
   "repository": {
     "type": "git",
@@ -36,6 +36,7 @@
     "@x402/axios": "^2.9.0",
     "@x402/core": "^2.9.0",
     "@x402/evm": "^2.9.0",
+    "axios": "^1.20.0",
     "viem": "^2.31.3",
     "zod": "^3.25.67"
   },