{ "openapi": "3.1.0", "info": { "title": "Datakoot x402 data API", "version": "2.8.1", "x-guidance": "Call POST /api/ with a JSON body of the tool's arguments (GET with a query string also works). Without payment you get HTTP 402 with an x402 v2 challenge (PAYMENT-REQUIRED header and JSON body): pay $0.01 USDC on Base (eip155:8453) to the listed payTo using the exact scheme, then retry with the PAYMENT-SIGNATURE header. Datakoot verifies the payment, runs the tool, and settles only if the tool succeeds; a tool error returns 422 with charged:false. Successful responses are plain JSON matching each operation's 200 schema, with the on-chain receipt in PAYMENT-RESPONSE. Start with cve_lookup, package_health, financials, country_profile or domain_report. MCP clients can use /mcp; every tool is also free for 100 calls/day at .datakoot.com/mcp.", "description": "48 live public-data tools (security, packages, SEC filings, economy, FX, weather, domains, Federal Register, Base) plus 4 Koot briefing tools that combine many lookups into one answer, for AI agents. $0.01 USDC per call (every tool and every Koot brief) on Base via x402, charged only on success. The same tools are free for 100 calls/day via MCP at .datakoot.com/mcp.", "contact": { "email": "hello@datakoot.com", "url": "https://datakoot.com" } }, "servers": [ { "url": "https://x402.datakoot.com" } ], "paths": { "/api/cve_lookup": { "post": { "operationId": "cve_lookup", "summary": "CVE Lookup (Security Intel)", "description": "Look up a CVE by ID and get a compact summary: description, CVSS score & severity, vector, CWE weakness, publish date, references — plus whether it is on the CISA Known-Exploited list (actively exploited in the wild) and its EPSS exploit-probability. Sources: NVD (NIST), CISA KEV, FIRST EPSS. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Security Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "cve_id": { "type": "string", "description": "CVE identifier, e.g. CVE-2021-44228 (case-insensitive; a bare 2021-44228 also works)." } }, "required": [ "cve_id" ] }, "example": { "cve_id": "CVE-2024-3094" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": {}, "status": {}, "description": {}, "cvss": {}, "cwe": {}, "published": {}, "last_modified": {}, "references": {}, "known_exploited": {}, "exploit_probability": {}, "sources": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/known_exploited": { "post": { "operationId": "known_exploited", "summary": "Known Exploited (Security Intel)", "description": "Check whether a CVE is on the CISA Known Exploited Vulnerabilities (KEV) catalog — confirmed exploited in the wild — or list the most recently added exploited vulnerabilities. Pass cve_id to check one; omit it to list recent (optionally filter by vendor/product, or ransomware_only). Source: CISA KEV, updated ~daily. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Security Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "cve_id": { "type": "string", "description": "Optional. Check a single CVE, e.g. CVE-2021-44228." }, "limit": { "type": "number", "description": "When listing, how many newest entries to return (default 20, max 100)." }, "vendor": { "type": "string", "description": "Optional. Filter by vendor or product name substring." }, "ransomware_only": { "type": "boolean", "description": "Optional. Only vulns CISA links to known ransomware campaigns." } }, "required": [] }, "example": { "limit": 5 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "catalog_version": {}, "catalog_count": {}, "released": {}, "returned": {}, "filter": {}, "vulnerabilities": {}, "source": {}, "cve_id": {}, "listed": {}, "vendor": {}, "product": {}, "name": {}, "date_added": {}, "due_date": {}, "known_ransomware_use": {}, "required_action": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/epss_score": { "post": { "operationId": "epss_score", "summary": "EPSS Score (Security Intel)", "description": "Get the EPSS exploit-probability score (0-1) and percentile for one or more CVEs — the likelihood each is exploited in the next 30 days. Use it to prioritize patching. Pass cve_id for one, or cve_ids (array or comma-separated) for many. Source: FIRST.org EPSS. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Security Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "cve_id": { "type": "string", "description": "A single CVE id." }, "cve_ids": { "type": "array", "items": { "type": "string" }, "description": "Multiple CVE ids (or pass a comma-separated string)." } }, "required": [] }, "example": { "cve_ids": [ "CVE-2024-3094", "CVE-2021-44228" ] } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "model": {}, "as_of": {}, "scored": {}, "scores": {}, "note": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/package_vulnerabilities": { "post": { "operationId": "package_vulnerabilities", "summary": "Package Vulnerabilities (Security Intel)", "description": "List known vulnerabilities for a software package (optionally a specific version) via OSV. Ecosystems: npm, pypi, cargo, go, maven, rubygems, nuget, composer, pub, hex. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Security Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": { "type": "string", "description": "Package registry to look in. One of: npm, pypi, cargo, go, maven, rubygems, nuget, composer, pub, hex." }, "name": { "type": "string", "description": "Exact package name as published in that registry, e.g. lodash for npm, requests for pypi." }, "version": { "type": "string", "description": "Optional; if given, only vulns affecting that version are returned" } }, "required": [ "ecosystem", "name" ] }, "example": { "ecosystem": "npm", "name": "lodash", "version": "4.17.15" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": {}, "name": {}, "version": {}, "vulnerability_count": {}, "vulnerabilities": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/audit_dependencies": { "post": { "operationId": "audit_dependencies", "summary": "Audit Dependencies (Security Intel)", "description": "Audit a whole dependency manifest for known vulnerabilities in one call. Paste a package.json (as 'manifest'), or pass a 'dependencies' array of {name, version} objects. Returns per-package findings and a summary. Ecosystem defaults to npm. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Security Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "manifest": { "type": "string", "description": "Raw package.json contents" }, "dependencies": { "type": "array", "items": { "type": "object" }, "description": "[{name, version}] entries" }, "ecosystem": { "type": "string", "description": "Package registry for the dependencies: npm (default), pypi, cargo, go, maven, rubygems, nuget, composer, pub, or hex." } }, "required": [] }, "example": { "manifest": "{\"dependencies\": {\"lodash\": \"4.17.15\", \"express\": \"4.17.1\"}}" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": {}, "packages_audited": {}, "packages_with_vulnerabilities": {}, "total_vulnerabilities": {}, "packages_not_found": {}, "packages_unverified": {}, "verdict": {}, "findings": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/package_info": { "post": { "operationId": "package_info", "summary": "Package Info (Package Intel)", "description": "Get core metadata for a package: latest version, description, license, homepage, source repository, maintainers, and whether it is deprecated. Use before an agent installs or recommends a dependency. Ecosystems: npm, pypi, cargo. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Package Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": { "type": "string", "enum": [ "npm", "pypi", "cargo" ], "description": "Package registry to look in. One of: npm, pypi, cargo." }, "name": { "type": "string", "description": "Package/crate name" } }, "required": [ "ecosystem", "name" ] }, "example": { "ecosystem": "pypi", "name": "requests" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": {}, "name": {}, "version": {}, "description": {}, "license": {}, "homepage": {}, "repository": {}, "maintainers": {}, "published": {}, "deprecated": {}, "requires_python": {}, "version_count": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/package_versions": { "post": { "operationId": "package_versions", "summary": "Package Versions (Package Intel)", "description": "List recent released versions of a package with release dates (most recent first). Helps an agent pick a version or check how actively it is maintained. Ecosystems: npm, pypi, cargo. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Package Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": { "type": "string", "enum": [ "npm", "pypi", "cargo" ], "description": "Package registry to look in. One of: npm, pypi, cargo." }, "name": { "type": "string", "description": "Exact package name as published in that registry, e.g. express for npm, requests for pypi, serde for cargo." }, "limit": { "type": "integer", "default": 15, "description": "Maximum number of results to return." } }, "required": [ "ecosystem", "name" ] }, "example": { "ecosystem": "npm", "name": "react", "limit": 5 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": {}, "name": {}, "latest": {}, "versions": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/package_downloads": { "post": { "operationId": "package_downloads", "summary": "Package Downloads (Package Intel)", "description": "Get popularity/download statistics for a package (recent download counts). Useful for judging how widely used and battle-tested a dependency is. Ecosystems: npm, pypi, cargo. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Package Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": { "type": "string", "enum": [ "npm", "pypi", "cargo" ], "description": "Package registry to look in. One of: npm, pypi, cargo." }, "name": { "type": "string", "description": "Exact package name as published in that registry, e.g. express for npm, requests for pypi, serde for cargo." } }, "required": [ "ecosystem", "name" ] }, "example": { "ecosystem": "npm", "name": "react" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": {}, "last_month": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/package_dependencies": { "post": { "operationId": "package_dependencies", "summary": "Package Dependencies (Package Intel)", "description": "List the direct dependencies of a specific package version (defaults to latest), via deps.dev. Lets an agent understand what a package pulls in before adding it. Ecosystems: npm, pypi, cargo. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Package Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": { "type": "string", "enum": [ "npm", "pypi", "cargo" ], "description": "Package registry to look in. One of: npm, pypi, cargo." }, "name": { "type": "string", "description": "Exact package name as published in that registry, e.g. express for npm, requests for pypi, serde for cargo." }, "version": { "type": "string", "description": "Optional; defaults to the latest/default version" } }, "required": [ "ecosystem", "name" ] }, "example": { "ecosystem": "cargo", "name": "serde" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": {}, "name": {}, "version": {}, "direct_dependency_count": {}, "required_dependency_count": {}, "direct_dependencies": {}, "build_dependency_count": {}, "dev_dependency_count": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/package_health": { "post": { "operationId": "package_health", "summary": "Package Health (Package Intel)", "description": "A composite trust/health check for a package an agent is considering: latest-release recency, deprecation status, license present, maintainer count, dependency count, and any known security advisories (via deps.dev). Returns a summary an agent can act on. Ecosystems: npm, pypi, cargo. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Package Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": { "type": "string", "enum": [ "npm", "pypi", "cargo" ], "description": "Package registry to look in. One of: npm, pypi, cargo." }, "name": { "type": "string", "description": "Exact package name as published in that registry, e.g. express for npm, requests for pypi, serde for cargo." } }, "required": [ "ecosystem", "name" ] }, "example": { "ecosystem": "npm", "name": "left-pad" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "latest_version": {}, "last_release": {}, "days_since_release": {}, "actively_maintained": {}, "deprecated": {}, "has_license": {}, "license": {}, "maintainers": {}, "known_advisories": {}, "advisory_ids": {}, "repository": {}, "verdict": {}, "concerns": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/package_search": { "post": { "operationId": "package_search", "summary": "Package Search (Package Intel)", "description": "Search for packages by keyword and get the top matches with descriptions. Supported ecosystems: npm and cargo (PyPI has no public search API). PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Package Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": { "type": "string", "enum": [ "npm", "cargo" ], "description": "Package registry to look in. One of: npm, pypi, cargo." }, "query": { "type": "string", "description": "Free-text search terms, matched against package names and descriptions." }, "limit": { "type": "integer", "default": 10, "description": "Maximum number of results to return." } }, "required": [ "ecosystem", "query" ] }, "example": { "ecosystem": "npm", "query": "mcp server", "limit": 5 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": {}, "query": {}, "result_count": {}, "results": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/company_lookup": { "post": { "operationId": "company_lookup", "summary": "Company Lookup (Filings Intel)", "description": "Resolve a stock ticker or company name to its SEC identity: CIK number, official name, ticker(s), exchange(s), industry (SIC), and fiscal year end. Start here before other Filings Intel calls. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Filings Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Ticker (e.g. AAPL), company name, or CIK" } }, "required": [ "query" ] }, "example": { "query": "NVDA" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "cik": {}, "name": {}, "tickers": {}, "exchanges": {}, "sic": {}, "industry": {}, "category": {}, "fiscal_year_end": {}, "ein": {}, "state": {}, "former_names": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/recent_filings": { "post": { "operationId": "recent_filings", "summary": "Recent Filings (Filings Intel)", "description": "List a company's most recent SEC filings (10-K annual reports, 10-Q quarterly, 8-K material events, S-1 IPO registrations, etc.) with filing dates and direct document links. Optionally filter by form type. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Filings Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Ticker, name, or CIK" }, "form_type": { "type": "string", "description": "Optional filter, e.g. 10-K, 10-Q, 8-K, 4" }, "limit": { "type": "integer", "default": 15, "description": "Maximum number of results to return." } }, "required": [ "query" ] }, "example": { "query": "TSLA", "limit": 5 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "company": {}, "cik": {}, "count": {}, "filings": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/filing_search": { "post": { "operationId": "filing_search", "summary": "Filing Search (Filings Intel)", "description": "Full-text search across all EDGAR filings for a keyword or phrase (e.g. a risk factor, product name, or executive). Returns matching filings with company, form type, and date. Optionally restrict to a form type. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Filings Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Words or an exact phrase to find anywhere in EDGAR filing text, e.g. \"going concern\" or a product name." }, "form_type": { "type": "string", "description": "Optional form filter, e.g. 8-K" }, "limit": { "type": "integer", "default": 10, "description": "Maximum number of results to return." } }, "required": [ "query" ] }, "example": { "query": "artificial intelligence", "form_type": "8-K", "limit": 5 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": {}, "total": {}, "results": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/financials": { "post": { "operationId": "financials", "summary": "Financials (Filings Intel)", "description": "Get reported financial facts for a company from XBRL data in its filings: revenue, net income, total assets, liabilities, equity, EPS, and cash — most recent reported values, or the full history of one specific us-gaap concept. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Filings Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Ticker, name, or CIK" }, "concept": { "type": "string", "description": "Optional specific us-gaap concept, e.g. Revenues, NetIncomeLoss, Assets" } }, "required": [ "query" ] }, "example": { "query": "AAPL", "concept": "Revenues" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "company": {}, "concept": {}, "unit": {}, "annual_only": {}, "history": {}, "note": {}, "cik": {}, "revenue": {}, "latest_reported": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/insider_transactions": { "post": { "operationId": "insider_transactions", "summary": "Insider Transactions (Filings Intel)", "description": "List recent insider ownership filings (Form 3/4/5) for a company — the filings officers, directors, and 10% owners submit when they buy or sell shares. Returns the filings with dates and links. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Filings Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Ticker, name, or CIK" }, "limit": { "type": "integer", "default": 15, "description": "Maximum number of results to return." } }, "required": [ "query" ] }, "example": { "query": "MSFT", "limit": 5 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "company": {}, "cik": {}, "note": {}, "filings": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/country_indicator": { "post": { "operationId": "country_indicator", "summary": "Country Indicator (Economy Intel)", "description": "Get a macroeconomic indicator for a country over recent years (World Bank). Indicators: gdp, gdp_per_capita, gdp_growth, inflation, unemployment, population, life_expectancy, exports, imports, govt_debt_pct_gdp, real_interest_rate, fdi, co2_per_capita, internet_users. Country accepts an ISO code (US, DE, JP) or a World Bank country code. You may also pass a raw World Bank indicator code. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Economy Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "country": { "type": "string", "description": "Country as an ISO code or name, e.g. JP, JPN, or Japan." }, "indicator": { "type": "string", "description": "World Bank indicator key: gdp, gdp_per_capita, gdp_growth, inflation, population, unemployment, life_expectancy, exports, imports, govt_debt_pct_gdp, real_interest_rate, fdi, co2_per_capita, internet_users. Call list_indicators for the full set. Raw World Bank codes are also accepted." }, "years": { "type": "integer", "default": 12, "description": "How many of the most recent years to return." } }, "required": [ "country", "indicator" ] }, "example": { "country": "DE", "indicator": "inflation", "years": 5 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "country": {}, "indicator": {}, "code": {}, "series": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/country_profile": { "post": { "operationId": "country_profile", "summary": "Country Profile (Economy Intel)", "description": "Get a snapshot of a country's key macro indicators (latest available values): GDP, GDP per capita, GDP growth, inflation, unemployment, and population. Country accepts an ISO code. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Economy Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "country": { "type": "string", "description": "Country as an ISO code or name, e.g. DE, DEU, or Germany." } }, "required": [ "country" ] }, "example": { "country": "JP" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "country": {}, "latest": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/compare_countries": { "post": { "operationId": "compare_countries", "summary": "Compare Countries (Economy Intel)", "description": "Compare one indicator across several countries (latest available value each). Good for ranking or benchmarking economies. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Economy Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "countries": { "type": "array", "items": { "type": "string" }, "description": "Array of country codes or names to compare, e.g. [\"US\", \"DE\", \"JP\"]." }, "indicator": { "type": "string", "description": "World Bank indicator key: gdp, gdp_per_capita, gdp_growth, inflation, population, unemployment, life_expectancy, exports, imports, govt_debt_pct_gdp, real_interest_rate, fdi, co2_per_capita, internet_users. Call list_indicators for the full set. Raw World Bank codes are also accepted." } }, "required": [ "countries", "indicator" ] }, "example": { "countries": [ "US", "CN", "IN" ], "indicator": "gdp" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "indicator": {}, "code": {}, "ranking": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/us_series": { "post": { "operationId": "us_series", "summary": "US Series (Economy Intel)", "description": "Get a key US economic time series. From the Bureau of Labor Statistics: us_unemployment_rate, us_cpi, us_nonfarm_payrolls, us_labor_participation, us_avg_hourly_earnings, us_ppi. From the US Census Bureau: us_retail_sales (advance retail & food services, seasonally adjusted). The BLS series are kept warm by Datakoot and always available. A raw BLS series ID is also accepted, but BLS rate-limits by client IP and Datakoot runs on shared edge IPs, so an uncached series may return an upstream-limit error instead of data; that error means the upstream refused, not that the series does not exist. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Economy Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "series": { "type": "string", "description": "A US series key: us_unemployment_rate, us_cpi, us_nonfarm_payrolls, us_labor_participation, us_avg_hourly_earnings, us_ppi (BLS), or us_retail_sales (US Census). These are cached by Datakoot and kept current. A raw BLS series ID is also accepted, but uncached series often hit BLS rate limits." } }, "required": [ "series" ] }, "example": { "series": "unemployment" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "series": {}, "seriesID": {}, "data": {}, "as_of": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/list_indicators": { "post": { "operationId": "list_indicators", "summary": "List Indicators (Economy Intel)", "description": "List the indicators this server supports (World Bank + US BLS), with descriptions. Call this to discover what you can query. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Economy Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {} }, "example": {} } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "world_bank": {}, "us_bls": {}, "us_census": {}, "note": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/fx_rates": { "post": { "operationId": "fx_rates", "summary": "FX Rates (Market Intel)", "description": "Get the latest foreign-exchange rates for a base currency (default USD), optionally limited to specific target currencies. Source: European Central Bank reference rates. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Market Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "base": { "type": "string", "description": "3-letter base currency, e.g. USD, EUR (default USD)" }, "symbols": { "type": "string", "description": "Optional comma-separated targets, e.g. EUR,GBP,JPY" } }, "required": [] }, "example": { "base": "USD", "symbols": "EUR,GBP,JPY" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "base": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "ISO 4217 base currency actually used" }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "ECB rate date YYYY-MM-DD" }, "rates": { "type": "object", "propertyNames": { "pattern": "^[A-Z]{3}$" }, "additionalProperties": { "type": "number" }, "minProperties": 1, "maxProperties": 256, "description": "Quote currencies mapped to the ECB reference rate" }, "source": { "type": "string" } }, "required": [ "base", "date", "rates", "source" ], "additionalProperties": false } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/fx_convert": { "post": { "operationId": "fx_convert", "summary": "FX Convert (Market Intel)", "description": "Convert an amount from one currency to another at the latest ECB reference rate. Returns the rate, the converted result, and the rate date. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Market Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "amount": { "type": "number", "description": "Amount in the 'from' currency to convert. Send it as a number, not a string." }, "from": { "type": "string", "description": "Source 3-letter currency" }, "to": { "type": "string", "description": "Target 3-letter currency" } }, "required": [ "amount", "from", "to" ] }, "example": { "amount": 250, "from": "GBP", "to": "USD" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "amount": {}, "from": {}, "to": {}, "rate": {}, "result": {}, "date": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/fx_historical": { "post": { "operationId": "fx_historical", "summary": "FX Historical (Market Intel)", "description": "Get foreign-exchange rates for a base currency on a specific past date (YYYY-MM-DD). ECB publishes rates on business days; a weekend/holiday date returns the most recent prior business day. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Market Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "date": { "type": "string", "description": "The date to look up, YYYY-MM-DD (MM/DD/YYYY is also accepted). Weekends and holidays return the previous business day's ECB rates." }, "base": { "type": "string", "description": "3-letter base (default USD)" }, "symbols": { "type": "string", "description": "Optional comma-separated targets" } }, "required": [ "date" ] }, "example": { "date": "2026-01-15", "base": "EUR", "symbols": "USD" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "base": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "ISO 4217 base currency actually used" }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "ECB rate date actually used YYYY-MM-DD" }, "requested_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "Caller-requested date YYYY-MM-DD" }, "rates": { "type": "object", "propertyNames": { "pattern": "^[A-Z]{3}$" }, "additionalProperties": { "type": "number" }, "minProperties": 1, "maxProperties": 256, "description": "Quote currencies mapped to the ECB reference rate" }, "source": { "type": "string" } }, "required": [ "base", "date", "requested_date", "rates", "source" ], "additionalProperties": false } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/fx_timeseries": { "post": { "operationId": "fx_timeseries", "summary": "FX Timeseries (Market Intel)", "description": "Get a time series of exchange rates for a base currency over a date range (max ~1 year), useful for trend analysis. Provide start and end as YYYY-MM-DD and one or more target currencies. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Market Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "start": { "type": "string", "description": "Start date, YYYY-MM-DD (MM/DD/YYYY is also accepted). Range up to about one year." }, "end": { "type": "string", "description": "End date, YYYY-MM-DD (MM/DD/YYYY is also accepted)." }, "base": { "type": "string", "description": "3-letter base (default USD)" }, "symbols": { "type": "string", "description": "Comma-separated targets, e.g. EUR,GBP" } }, "required": [ "start", "end", "symbols" ] }, "example": { "start": "2026-09-01", "end": "2026-09-10", "base": "USD", "symbols": "EUR" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "base": {}, "start_date": {}, "end_date": {}, "rates": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/fx_currencies": { "post": { "operationId": "fx_currencies", "summary": "FX Currencies (Market Intel)", "description": "List the currencies supported for exchange-rate lookups, with their full names. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Market Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "required": [] }, "example": {} } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": { "type": "integer", "description": "Number of supported currencies" }, "currencies": { "type": "object", "propertyNames": { "pattern": "^[A-Z]{3}$" }, "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 128 }, "minProperties": 1, "maxProperties": 256, "description": "ISO 4217 codes mapped to currency names" }, "source": { "type": "string" } }, "required": [ "count", "currencies", "source" ], "additionalProperties": false } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/geocode": { "post": { "operationId": "geocode", "summary": "Geocode (Weather & Geo)", "description": "Convert a US street address OR a city/town name into latitude/longitude coordinates, using US Census data. Accepts both '1600 Pennsylvania Ave NW, Washington DC' and 'Chicago, IL' - a place name returns the centroid of the city. Call this first whenever you have a location as text and need coordinates for the weather or elevation tools. US locations only. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Weather & Geo" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string", "description": "A US street address ('1600 Pennsylvania Ave NW, Washington DC') or a city or town ('Chicago, IL', 'Springdale, Arkansas')" } }, "required": [ "address" ] }, "example": { "address": "1600 Pennsylvania Ave NW, Washington, DC" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": {}, "matched_by": {}, "matches": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/weather_forecast": { "post": { "operationId": "weather_forecast", "summary": "Weather Forecast (Weather & Geo)", "description": "Get a multi-day weather forecast for a US location by latitude/longitude (National Weather Service). Returns named periods (Today, Tonight, ...) with temperature, wind, and a short + detailed forecast. Use geocode first if you only have an address. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Weather & Geo" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "lat": { "type": "number", "description": "Latitude in decimal degrees, e.g. 36.1867. US coverage only (National Weather Service)." }, "lon": { "type": "number", "description": "Longitude in decimal degrees, negative in the western hemisphere, e.g. -94.1288." }, "hourly": { "type": "boolean", "description": "If true, return the hourly forecast instead of daily periods.", "default": false } }, "required": [ "lat", "lon" ] }, "example": { "lat": 40.27, "lon": -76.88 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": {}, "timezone": {}, "type": {}, "periods": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/weather_current": { "post": { "operationId": "weather_current", "summary": "Weather Current (Weather & Geo)", "description": "Get the latest observed weather conditions for a US location by latitude/longitude, from the nearest NWS observation station: temperature, humidity, wind, and text description. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Weather & Geo" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "lat": { "type": "number", "description": "Latitude in decimal degrees, e.g. 36.1867. US coverage only (National Weather Service)." }, "lon": { "type": "number", "description": "Longitude in decimal degrees, negative in the western hemisphere, e.g. -94.1288." } }, "required": [ "lat", "lon" ] }, "example": { "lat": 40.27, "lon": -76.88 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": {}, "station": {}, "observed": {}, "description": {}, "temperature": {}, "humidity": {}, "wind": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/weather_alerts": { "post": { "operationId": "weather_alerts", "summary": "Weather Alerts (Weather & Geo)", "description": "List active NWS weather alerts (warnings, watches, advisories) for a US state or marine area. Pass a two-letter state code like CA, TX, FL. Returns event type, severity, headline, affected area and expiry. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Weather & Geo" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "area": { "type": "string", "description": "Two-letter US state code, e.g. PA, TX, CA (full state names such as Pennsylvania are also accepted)." } }, "required": [ "area" ] }, "example": { "area": "PA" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "area": {}, "active_count": {}, "alerts": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/earthquakes": { "post": { "operationId": "earthquakes", "summary": "Earthquakes (Weather & Geo)", "description": "List recent earthquakes worldwide from the USGS feed. Filter by minimum magnitude, look-back window in days, and optionally a bounding box or a point+radius (km). Returns magnitude, place, time, depth and coordinates. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Weather & Geo" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "min_magnitude": { "type": "number", "default": 4.5, "description": "Only return quakes at or above this magnitude." }, "days": { "type": "integer", "description": "Look back this many days (default 7, max 30).", "default": 7 }, "lat": { "type": "number", "description": "Optional center latitude for a radius search." }, "lon": { "type": "number", "description": "Optional center longitude for a radius search." }, "radius_km": { "type": "number", "description": "Radius in km around lat/lon (requires lat+lon)." }, "limit": { "type": "integer", "default": 20, "description": "Maximum number of quakes to return." } }, "required": [] }, "example": { "min_magnitude": 4.5, "days": 3, "limit": 5 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": {}, "criteria": {}, "earthquakes": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/elevation": { "post": { "operationId": "elevation", "summary": "Elevation (Weather & Geo)", "description": "Get the ground elevation at a latitude/longitude within the US, from the USGS Elevation Point Query Service. Returns elevation in feet and meters. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Weather & Geo" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "lat": { "type": "number", "description": "Latitude in decimal degrees, e.g. 39.5883. US coverage only (USGS)." }, "lon": { "type": "number", "description": "Longitude in decimal degrees, negative in the western hemisphere, e.g. -105.6438." } }, "required": [ "lat", "lon" ] }, "example": { "lat": 39.7392, "lon": -104.9903 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "lat": {}, "lon": {}, "elevation_m": {}, "elevation_ft": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/domain_report": { "post": { "operationId": "domain_report", "summary": "Domain Report (Domain Intel)", "description": "One-call full dossier on a domain: registration (RDAP), DNS records, email deliverability, and website tech stack, combined into a single report. Use for fast lead qualification, company research, or recon without four separate calls. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Domain Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain name, e.g. stripe.com" } }, "required": [ "domain" ] }, "example": { "domain": "anthropic.com" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": {}, "registration": {}, "dns": {}, "email": {}, "tech": {}, "_datakoot_note": {}, "free_tier_note": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/domain_intel": { "post": { "operationId": "domain_intel", "summary": "Domain Intel (Domain Intel)", "description": "Registration intelligence for a domain via RDAP (the modern WHOIS). Returns registrar, creation/expiration/last-changed dates, domain age in years, EPP status codes, nameservers, DNSSEC state, and abuse contact. Use to vet a company, assess a lead, or judge how established a domain is. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Domain Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain name, e.g. stripe.com (no scheme)" } }, "required": [ "domain" ] }, "example": { "domain": "github.com" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": {}, "found": {}, "registrar": {}, "created": {}, "expires": {}, "last_changed": {}, "age_years": {}, "status": {}, "nameservers": {}, "dnssec_signed": {}, "abuse_contact": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/dns_lookup": { "post": { "operationId": "dns_lookup", "summary": "DNS Lookup (Domain Intel)", "description": "Look up DNS records for a domain via Cloudflare DNS-over-HTTPS. Returns A, AAAA, MX, NS, TXT, CNAME, and SOA records. Use to see where a domain is hosted, who runs its mail and DNS, and what verification/policy TXT records it publishes. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Domain Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain name, e.g. stripe.com" }, "types": { "type": "array", "items": { "type": "string" }, "description": "Optional subset of record types, e.g. [\"MX\",\"TXT\"]. Defaults to all common types." } }, "required": [ "domain" ] }, "example": { "domain": "cloudflare.com", "types": [ "A", "MX" ] } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": {}, "records": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/email_deliverability": { "post": { "operationId": "email_deliverability", "summary": "Email Deliverability (Domain Intel)", "description": "Assess whether a domain (or the domain of an email address) can receive mail and how strong its sender authentication is. Returns MX presence, SPF and DMARC policy, whether it's a free consumer provider (gmail, etc.) or a known disposable/temp-mail provider, and an overall verdict. Use to qualify leads and flag throwaway signups. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Domain Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain_or_email": { "type": "string", "description": "A domain (stripe.com) or an email address (a@stripe.com)" } }, "required": [ "domain_or_email" ] }, "example": { "domain_or_email": "google.com" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": {}, "can_receive_mail": {}, "mx_hosts": {}, "spf": {}, "spf_checked": {}, "dmarc_policy": {}, "dmarc_record": {}, "dmarc_checked": {}, "is_free_provider": {}, "is_disposable": {}, "auth_posture": {}, "verdict": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/tech_stack": { "post": { "operationId": "tech_stack", "summary": "Tech Stack (Domain Intel)", "description": "Fingerprint the technology behind a website by fetching its homepage. Detects web server, CMS/framework (WordPress, Shopify, Next.js, etc.), CDN, analytics, and returns the page title, final URL after redirects, and key response headers. Use for competitive research and lead enrichment. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Domain Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain or full URL, e.g. shopify.com" } }, "required": [ "domain" ] }, "example": { "domain": "shopify.com" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": {}, "status": {}, "title": {}, "server": {}, "powered_by": {}, "cdn": {}, "generator": {}, "technologies": {}, "analytics": {}, "security_headers": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/subdomains": { "post": { "operationId": "subdomains", "summary": "Subdomains (Domain Intel)", "description": "Discover a domain's public subdomains (app., api., staging., and so on) from Certificate Transparency logs, querying crt.sh and Cert Spotter in parallel and returning whichever answers first. Useful for mapping a company's public attack surface or infrastructure. If both sources are down the call returns an error rather than an empty list. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Domain Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Registrable domain, e.g. stripe.com" } }, "required": [ "domain" ] }, "example": { "domain": "datakoot.com" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": {}, "available": {}, "count": {}, "subdomains": {}, "truncated": {}, "source": {}, "_datakoot_note": {}, "free_tier_note": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/search_documents": { "post": { "operationId": "search_documents", "summary": "Search Documents (Regulatory Intel)", "description": "Search the US Federal Register for regulations and notices. Filter by keyword, document type (rule, proposed_rule, notice, presidential_document), issuing agency (slug from the agencies tool), and publication date. Returns matching documents with title, type, agencies, abstract and links. Great for 'what did agency X publish about topic Y'. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Regulatory Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "term": { "type": "string", "description": "Keyword(s) to search, e.g. 'artificial intelligence', 'PFAS'." }, "type": { "type": "string", "enum": [ "rule", "proposed_rule", "notice", "presidential_document" ], "description": "Restrict to one document type." }, "agency": { "type": "string", "description": "Agency slug (from the 'agencies' tool), e.g. 'environmental-protection-agency'." }, "since": { "type": "string", "description": "Only documents published on/after this date (YYYY-MM-DD)." }, "until": { "type": "string", "description": "Only documents published on/before this date (YYYY-MM-DD)." }, "per_page": { "type": "integer", "description": "Results to return (default 10, max 30).", "default": 10 } }, "required": [] }, "example": { "term": "artificial intelligence", "per_page": 5 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": {}, "total_pages": {}, "results": {}, "source": {}, "note": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/document": { "post": { "operationId": "document", "summary": "Document (Regulatory Intel)", "description": "Get full detail on a single Federal Register document by its document number (e.g. '2026-12811'): abstract, action, effective date, comment deadline, CFR references, citation, topics, agencies and links. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Regulatory Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "document_number": { "type": "string", "description": "Federal Register document number, e.g. 2026-17888. Get one from search_documents or recent_documents." } }, "required": [ "document_number" ] }, "example": { "document_number": "2024-24283" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "title": {}, "type": {}, "document_number": {}, "citation": {}, "publication_date": {}, "effective_on": {}, "action": {}, "abstract": {}, "dates": {}, "comments_close_on": {}, "agencies": {}, "topics": {}, "cfr_references": {}, "regulation_id_numbers": {}, "executive_order_number": {}, "signing_date": {}, "significant": {}, "html_url": {}, "pdf_url": {}, "source": {}, "note": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/recent_documents": { "post": { "operationId": "recent_documents", "summary": "Recent Documents (Regulatory Intel)", "description": "List the most recent Federal Register documents, optionally filtered by type and issuing agency, over a look-back window. Use this to monitor newly published rules/notices from an agency. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Regulatory Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "rule", "proposed_rule", "notice", "presidential_document" ], "description": "Document type. One of: rule, proposed_rule, notice, presidential_document." }, "agency": { "type": "string", "description": "Agency slug (from the 'agencies' tool)." }, "days": { "type": "integer", "description": "Look back this many days (default 7, max 90).", "default": 7 }, "per_page": { "type": "integer", "description": "Results to return (default 15, max 30).", "default": 15 } }, "required": [] }, "example": { "days": 3, "per_page": 5 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "window_days": {}, "since": {}, "count": {}, "total_pages": {}, "results": {}, "source": {}, "note": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/executive_orders": { "post": { "operationId": "executive_orders", "summary": "Executive Orders (Regulatory Intel)", "description": "Search recent US presidential Executive Orders published in the Federal Register. Optionally filter by keyword and date. Returns EO number, signing/publication date, title and links. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Regulatory Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "term": { "type": "string", "description": "Optional keyword to search within executive orders." }, "since": { "type": "string", "description": "Only EOs published on/after this date (YYYY-MM-DD)." }, "per_page": { "type": "integer", "description": "Results to return (default 10, max 30).", "default": 10 } }, "required": [] }, "example": { "per_page": 5 } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": {}, "total_pages": {}, "results": {}, "source": {}, "note": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/agencies": { "post": { "operationId": "agencies", "summary": "Agencies (Regulatory Intel)", "description": "Look up US federal agencies and their slugs (used to filter the other tools by issuing agency). Optionally pass a query to match by name, e.g. 'environmental' or 'defense'. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Regulatory Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "Filter agencies whose name contains this text." } }, "required": [] }, "example": { "query": "energy" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": {}, "agencies": {}, "source": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/address_report": { "post": { "operationId": "address_report", "summary": "Address Report (Base Intel)", "description": "One-call snapshot of any Base address: ETH balance, USDC balance, transaction count, and whether it is a smart contract or a regular wallet. Use it to sanity-check a counterparty or a payment address before sending funds. Input: a 0x address. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Base Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string", "description": "0x address on Base" } }, "required": [ "address" ] }, "example": { "address": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "address": {}, "network": {}, "eth_balance": {}, "usdc_balance": {}, "tx_count": {}, "is_contract": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/token_info": { "post": { "operationId": "token_info", "summary": "Token Info (Base Intel)", "description": "ERC-20 token metadata on Base, read on-chain: name, symbol, decimals, and total supply, plus whether the address really behaves like an ERC-20. Use it to verify a token contract before trusting or displaying it. Input: the token contract address (0x + 40 hex). PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Base Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string", "description": "ERC-20 contract address on Base: 0x followed by 40 hex characters." } }, "required": [ "token" ] }, "example": { "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "token": {}, "network": {}, "is_erc20": {}, "name": {}, "symbol": {}, "decimals": {}, "total_supply": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/token_balance": { "post": { "operationId": "token_balance", "summary": "Token Balance (Base Intel)", "description": "How much of an ERC-20 token a wallet holds on Base, returned both human-formatted (using the token's decimals) and raw. Pass the token contract address and the holder address, both 0x + 40 hex. Example: USDC 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Base Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string", "description": "ERC-20 contract address on Base: 0x followed by 40 hex characters." }, "address": { "type": "string", "description": "Wallet address whose balance to read: 0x followed by 40 hex characters." } }, "required": [ "token", "address" ] }, "example": { "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "address": "0x21217f943Fe780A3E95eBe3dfC95bEF2203cF3bB" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "token": {}, "holder": {}, "network": {}, "symbol": {}, "balance": {}, "balance_raw": {}, "decimals": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/gas_now": { "post": { "operationId": "gas_now", "summary": "Gas Now (Base Intel)", "description": "Current gas price on the Base network (Coinbase's Ethereum L2), in gwei and wei, read live from a Base RPC node. Use before sending a Base transaction or estimating its cost. Takes no input. PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Base Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {} }, "example": {} } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "network": {}, "gas_price_wei": {}, "gas_price_gwei": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/tx_status": { "post": { "operationId": "tx_status", "summary": "Tx Status (Base Intel)", "description": "Look up a Base transaction by hash and report whether it is pending, succeeded, or failed, with from, to, value, block number, and gas used. Use it to confirm a payment or contract call landed. Input: the transaction hash (0x + 64 hex; the 0x is optional). PAID: $0.01 USDC per call via x402 (charged only on success).", "tags": [ "Base Intel" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "hash": { "type": "string", "description": "Transaction hash, 0x followed by 64 hex characters (the 0x prefix is optional)." } }, "required": [ "hash" ] }, "example": { "hash": "0xce51d48ff5b3a2b6c85aa7e6f3ac92c1defe89c9fc6532eaeae4d414d175b068" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "hash": {}, "found": {}, "network": {}, "from": {}, "to": {}, "value_eth": {}, "block_number": {}, "status": {}, "gas_used": {} }, "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/brief_stack": { "post": { "operationId": "brief_stack", "summary": "Ask Koot: Is My Stack Safe? (Koot)", "description": "One call answers 'is my project safe?'. Checks every package for known vulnerabilities, tells you which are being EXPLOITED IN THE WILD right now (CISA KEV) or likely to be (EPSS), flags abandoned/deprecated packages, and returns a ranked fix-first list. Accepts a package list or a pasted package.json / requirements.txt. PAID: $0.01 USDC per brief via x402 (one brief runs many lookups; charged only on success).", "tags": [ "Koot" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "packages": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "object", "properties": { "name": { "type": "string" }, "version": { "type": "string" }, "ecosystem": { "type": "string" } }, "required": [ "name" ] } ] }, "description": "Packages as 'name' or 'name@version' strings (or {name, version, ecosystem} objects), e.g. [\"lodash@4.17.15\", \"express\"]." }, "ecosystem": { "type": "string", "enum": [ "npm", "pypi", "cargo", "go", "maven", "rubygems", "nuget", "composer" ], "description": "Registry for string packages (default npm)." }, "manifest": { "type": "string", "description": "Or paste a whole package.json or requirements.txt here." } } }, "example": { "packages": [ "lodash@4.17.15", "express@4.17.1" ] } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "koot": { "type": "string", "description": "Koot's one-line answer." } }, "required": [ "koot" ], "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/brief_company": { "post": { "operationId": "brief_company", "summary": "Ask Koot: Brief Me on a Company (Koot)", "description": "One call briefs you on a US public company: SEC profile, recent filings (8-K material events flagged), insider trades and reported financials. Give a ticker, name or CIK. PAID: $0.01 USDC per brief via x402 (one brief runs many lookups; charged only on success).", "tags": [ "Koot" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company": { "type": "string", "description": "Ticker (TSLA), company name (Tesla) or CIK." } }, "required": [ "company" ] }, "example": { "company": "TSLA" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "koot": { "type": "string", "description": "Koot's one-line answer." } }, "required": [ "koot" ], "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/brief_domain": { "post": { "operationId": "brief_domain", "summary": "Ask Koot: Check a Domain (Koot)", "description": "One call checks a domain: registration and DNS, email security (SPF/DKIM/DMARC), tech stack, and subdomains from certificate logs. PAID: $0.01 USDC per brief via x402 (one brief runs many lookups; charged only on success).", "tags": [ "Koot" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Domain, e.g. stripe.com." } }, "required": [ "domain" ] }, "example": { "domain": "stripe.com" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "koot": { "type": "string", "description": "Koot's one-line answer." } }, "required": [ "koot" ], "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } }, "/api/brief_place": { "post": { "operationId": "brief_place", "summary": "Ask Koot: What's Happening at a Place? (Koot)", "description": "One call briefs you on a US place: current conditions, forecast, active weather alerts for the state, nearby earthquakes and elevation. PAID: $0.01 USDC per brief via x402 (one brief runs many lookups; charged only on success).", "tags": [ "Koot" ], "x-payment-info": { "price": { "currency": "USD", "mode": "fixed", "amount": "0.01" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "payTo": "0x3de7b2de531053340cf132d29b837e5a0e924177" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "place": { "type": "string", "description": "US city or address, e.g. 'Harrisburg, PA'." } }, "required": [ "place" ] }, "example": { "place": "Harrisburg, PA" } } } }, "responses": { "200": { "description": "Tool result (charged)", "content": { "application/json": { "schema": { "type": "object", "properties": { "koot": { "type": "string", "description": "Koot's one-line answer." } }, "required": [ "koot" ], "additionalProperties": true } } } }, "402": { "description": "Payment required: x402 challenge in the PAYMENT-REQUIRED header and body" }, "422": { "description": "Tool error (not charged)" } } } } } }