ambolt 0.1.0__tar.gz

ambolt-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Ambolt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this documentation and associated files, to deal in them without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies, and to permit persons to whom they are furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions.
+
+THE DOCUMENTATION IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED.

ambolt-0.1.0/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: ambolt
+Version: 0.1.0
+Summary: Client for the Ambolt pay-per-call data tools (x402, USDC): electricity, company registers, tenders, FX, DNS, on-chain facts.
+License: MIT
+Project-URL: Homepage, https://ambolt.dev
+Project-URL: Documentation, https://ambolt.dev/docs
+Project-URL: Source, https://github.com/ambolt/ambolt-mcp
+Keywords: x402,mcp,ai-agents,data-api,usdc
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ambolt
+
+Client for [Ambolt](https://ambolt.dev): dated, sourced data lookups as pay-per-call endpoints (x402, USDC). Failed calls are never charged.
+
+```python
+from ambolt import Ambolt
+
+ambolt = Ambolt(session=paying_session)  # a requests-compatible session that pays x402 challenges
+print(ambolt.iban_validate(iban="DK5000400440116243"))
+print(ambolt.call("dk-electricity-prices", area="DK1"))
+```
+
+Every function is also an MCP tool at `https://api.ambolt.dev/mcp`. Not financial, legal or tax advice.

ambolt-0.1.0/README.md

@@ -0,0 +1,13 @@
+# ambolt
+
+Client for [Ambolt](https://ambolt.dev): dated, sourced data lookups as pay-per-call endpoints (x402, USDC). Failed calls are never charged.
+
+```python
+from ambolt import Ambolt
+
+ambolt = Ambolt(session=paying_session)  # a requests-compatible session that pays x402 challenges
+print(ambolt.iban_validate(iban="DK5000400440116243"))
+print(ambolt.call("dk-electricity-prices", area="DK1"))
+```
+
+Every function is also an MCP tool at `https://api.ambolt.dev/mcp`. Not financial, legal or tax advice.

ambolt-0.1.0/ambolt/__init__.py

@@ -0,0 +1,60 @@
+"""Ambolt: client for the pay-per-call data tools at https://ambolt.dev (x402, USDC). Zero dependencies.
+
+Payment: pass a requests-compatible session that pays x402 challenges (for example from the `x402` package).
+Without one, calls raise AmboltError with status 402 and the price challenge.
+"""
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+
+from ._generated import FUNCTIONS
+
+__all__ = ["Ambolt", "AmboltError", "FUNCTIONS"]
+__version__ = "0.1.0"
+
+
+class AmboltError(Exception):
+    def __init__(self, message, status=None, body=None):
+        super().__init__(message)
+        self.status = status
+        self.body = body
+
+
+def _encode(v):
+    return json.dumps(v, separators=(",", ":")) if isinstance(v, (list, dict)) else str(v).lower() if isinstance(v, bool) else str(v)
+
+
+class Ambolt:
+    def __init__(self, session=None, base_url="https://api.ambolt.dev"):
+        self.session = session
+        self.base_url = base_url.rstrip("/")
+        self.mcp_url = self.base_url + "/mcp"
+        self.functions = FUNCTIONS
+        for fn in FUNCTIONS:
+            setattr(self, fn["py"], self._method(fn["id"]))
+
+    def _method(self, fn_id):
+        return lambda **params: self.call(fn_id, **params)
+
+    def call(self, fn_id, **params):
+        qs = urllib.parse.urlencode({k: _encode(v) for k, v in params.items() if v is not None})
+        url = f"{self.base_url}/v1/{fn_id}?{qs}"
+        if self.session is not None:
+            r = self.session.get(url, headers={"accept": "application/json"})
+            status, text = r.status_code, r.text
+        else:
+            try:
+                with urllib.request.urlopen(urllib.request.Request(url, headers={"accept": "application/json"}), timeout=30) as r:
+                    status, text = r.status, r.read().decode("utf-8")
+            except urllib.error.HTTPError as e:
+                status, text = e.code, e.read().decode("utf-8", "replace")
+        try:
+            body = json.loads(text)
+        except ValueError:
+            body = None
+        if status == 402:
+            raise AmboltError("payment required: pass a session that pays x402", status, body)
+        if status >= 400:
+            raise AmboltError((body or {}).get("error", f"HTTP {status}"), status, body)
+        return body

ambolt-0.1.0/ambolt/_generated.py

@@ -0,0 +1,315 @@
+# Generated by sdk/generate.mjs. Do not edit.
+FUNCTIONS = [
+ {
+  "id": "base-erc20-balance",
+  "py": "base_erc20_balance",
+  "description": "ERC-20 token balance of a wallet address on Base mainnet (USDC, WETH, any token): raw units, decimals, symbol and formatted amount, read live via eth_call..",
+  "priceUsd": 0.003,
+  "required": [
+   "address",
+   "token"
+  ]
+ },
+ {
+  "id": "base-token-facts",
+  "py": "base_token_facts",
+  "description": "Verifiable on-chain facts about an ERC-20 token on Base: name, symbol, supply, whether the contract has an owner (and whether it was renounced), whether it is an upgradeable proxy and who administers it, whether it is paused, and which privileged functions (mint, burn, pause, blacklist, fee setting, upgrade) appear in its bytecode.",
+  "priceUsd": 0.01,
+  "required": [
+   "token"
+  ]
+ },
+ {
+  "id": "base-token-info",
+  "py": "base_token_info",
+  "description": "Basic facts about an ERC-20 token contract on Base mainnet: name, symbol, decimals and total supply (raw and formatted), read live via eth_call.",
+  "priceUsd": 0.003,
+  "required": [
+   "token"
+  ]
+ },
+ {
+  "id": "base-transaction",
+  "py": "base_transaction",
+  "description": "Look up a transaction on Base by hash: success or revert, block and time, sender, recipient, ETH value, gas and fee, the called method selector, and decoded ERC-20 transfers with token symbols.",
+  "priceUsd": 0.005,
+  "required": [
+   "hash"
+  ]
+ },
+ {
+  "id": "base-wallet-balances",
+  "py": "base_wallet_balances",
+  "description": "ETH balance and balances of major tokens (USDC, WETH, cbBTC, DAI, USDbC, cbETH, AERO) for any address on Base, plus any extra token contracts you list.",
+  "priceUsd": 0.005,
+  "required": [
+   "address"
+  ]
+ },
+ {
+  "id": "disposable-email-check",
+  "py": "disposable_email_check",
+  "description": "Fast email address check without sending anything: syntax, domain MX records, disposable/temporary-mail domain (9,000+ listed), role address (info@, admin@) and likely typo of a popular provider.",
+  "priceUsd": 0.003,
+  "required": [
+   "email"
+  ]
+ },
+ {
+  "id": "dk-co2-intensity",
+  "py": "dk_co2_intensity",
+  "description": "CO2 emissions per kWh of electricity consumed in Denmark (DK1 West, DK2 East), latest 5-minute value plus 24-hour average, cleanest and dirtiest times..",
+  "priceUsd": 0.005,
+  "required": []
+ },
+ {
+  "id": "dk-electricity-prices",
+  "py": "dk_electricity_prices",
+  "description": "Day-ahead electricity spot prices for one day and bidding area, in EUR and DKK per MWh, quarter-hourly or hourly, with min/max/average and the cheapest hours.",
+  "priceUsd": 0.01,
+  "required": []
+ },
+ {
+  "id": "dns-lookup",
+  "py": "dns_lookup",
+  "description": "Resolve public DNS records for a domain (A, AAAA, MX, TXT, NS, CNAME) and report whether SPF and DMARC records are present, with their policies.",
+  "priceUsd": 0.003,
+  "required": [
+   "domain"
+  ]
+ },
+ {
+  "id": "doi-lookup",
+  "py": "doi_lookup",
+  "description": "Scholarly metadata by DOI, or a best-match search by citation text: title, authors, journal, year, publisher, citation count, licence links and URL.",
+  "priceUsd": 0.003,
+  "required": []
+ },
+ {
+  "id": "domain-rdap",
+  "py": "domain_rdap",
+  "description": "Look up a domain in the public RDAP registry: registration, last-changed and expiry dates, status codes, nameservers, DNSSEC flag and registrar name.",
+  "priceUsd": 0.003,
+  "required": [
+   "domain"
+  ]
+ },
+ {
+  "id": "domain-ssl-sweep",
+  "py": "domain_ssl_sweep",
+  "description": "Check SSL certificate and domain registration expiry for one domain or a whole list: certificate issuer, valid from and to, days left, trusted or not, domain registration and expiry dates, registrar and nameservers.",
+  "priceUsd": 0.005,
+  "required": []
+ },
+ {
+  "id": "ecb-key-rates",
+  "py": "ecb_key_rates",
+  "description": "The three ECB key interest rates with their latest change dates and recent history.",
+  "priceUsd": 0.003,
+  "required": []
+ },
+ {
+  "id": "ens-resolve",
+  "py": "ens_resolve",
+  "description": "Resolve an ENS name (e.g.",
+  "priceUsd": 0.003,
+  "required": []
+ },
+ {
+  "id": "entity-resolve",
+  "py": "entity_resolve",
+  "description": "Resolve a company name, website domain, registry number, LEI or VAT number to its official legal entity: registry, registry number, legal form, status, address, industry codes, size where published and LEI.",
+  "priceUsd": 0.01,
+  "required": []
+ },
+ {
+  "id": "eu-vat-validate",
+  "py": "eu_vat_validate",
+  "description": "Check whether an EU VAT number is valid and active.",
+  "priceUsd": 0.003,
+  "required": [
+   "vat"
+  ]
+ },
+ {
+  "id": "fx-rate-ecb",
+  "py": "fx_rate_ecb",
+  "description": "European Central Bank euro foreign-exchange reference rates for any date since 1999, converted to any base currency.",
+  "priceUsd": 0.003,
+  "required": []
+ },
+ {
+  "id": "iban-validate",
+  "py": "iban_validate",
+  "description": "Validate an IBAN offline: ISO 13616 checksum (mod 97), registered length for the country, and a normalised and grouped format.",
+  "priceUsd": 0.003,
+  "required": [
+   "iban"
+  ]
+ },
+ {
+  "id": "lei-lookup",
+  "py": "lei_lookup",
+  "description": "Look up a Legal Entity Identifier (LEI) record by 20-character LEI, or search legal entities by name and country.",
+  "priceUsd": 0.005,
+  "required": []
+ },
+ {
+  "id": "nordic-company-lookup",
+  "py": "nordic_company_lookup",
+  "description": "Look up companies in the Norwegian and Finnish company registers by registration number or name: name, legal form, industry, address, registration date and status.",
+  "priceUsd": 0.005,
+  "required": [
+   "country"
+  ]
+ },
+ {
+  "id": "package-vulnerabilities",
+  "py": "package_vulnerabilities",
+  "description": "Check an npm or PyPI package version against a public vulnerability database: advisory ids, aliases (CVE, GHSA), summary, severity label and first fixed version, plus the latest published version.",
+  "priceUsd": 0.003,
+  "required": [
+   "ecosystem",
+   "name"
+  ]
+ },
+ {
+  "id": "rss-feed-normaliser",
+  "py": "rss_feed_normaliser",
+  "description": "Turn any RSS 2.0, RSS 1.0, Atom or JSON Feed into one clean JSON schema: feed title, link and language, then items with id, title, URL, ISO published/updated dates, summary, categories and enclosure.",
+  "priceUsd": 0.003,
+  "required": [
+   "url"
+  ]
+ },
+ {
+  "id": "sitemap-robots-doctor",
+  "py": "sitemap_robots_doctor",
+  "description": "Audit a website's robots.txt and XML sitemaps in one call: user-agent groups and blocked paths, sitemap declarations, whether each sitemap loads, URL counts (indexes followed to 10 files), lastmod coverage and age, duplicates, off-host and non-HTTPS URLs, size-limit breaches, and a sample of listed URLs checked for status.",
+  "priceUsd": 0.005,
+  "required": [
+   "site"
+  ]
+ },
+ {
+  "id": "solana-swap-quote",
+  "py": "solana_swap_quote",
+  "description": "Get a swap quote on Solana through a DEX aggregator: expected output, minimum output after slippage, price impact, route venues and all fees in basis points.",
+  "priceUsd": 0.003,
+  "required": [
+   "inputMint",
+   "outputMint",
+   "amount"
+  ]
+ },
+ {
+  "id": "solana-swap-transaction",
+  "py": "solana_swap_transaction",
+  "description": "Build an unsigned Solana swap transaction through a DEX aggregator for a wallet you control.",
+  "priceUsd": 0.003,
+  "required": [
+   "inputMint",
+   "outputMint",
+   "amount",
+   "taker"
+  ]
+ },
+ {
+  "id": "solana-token-facts",
+  "py": "solana_token_facts",
+  "description": "Verifiable on-chain facts about a Solana token mint: whether the mint and freeze authorities are still set, total supply, decimals, token program, and how much of the supply the largest token accounts hold, plus public market metrics from a token index.",
+  "priceUsd": 0.01,
+  "required": [
+   "mint"
+  ]
+ },
+ {
+  "id": "solana-token-price",
+  "py": "solana_token_price",
+  "description": "Current USD price, 24-hour change, liquidity and decimals for up to 50 Solana token mints in one call, from an aggregated market feed.",
+  "priceUsd": 0.003,
+  "required": [
+   "mints"
+  ]
+ },
+ {
+  "id": "solana-token-search",
+  "py": "solana_token_search",
+  "description": "Find Solana tokens by symbol, name or mint address: mint, decimals, verification flag, organic score, liquidity, market cap and holder count.",
+  "priceUsd": 0.003,
+  "required": [
+   "query"
+  ]
+ },
+ {
+  "id": "solana-transaction",
+  "py": "solana_transaction",
+  "description": "Look up a confirmed Solana transaction by signature: success or error, time, fee, signers, programs used, and the resulting SOL and token balance changes per account.",
+  "priceUsd": 0.005,
+  "required": [
+   "signature"
+  ]
+ },
+ {
+  "id": "solana-wallet-balances",
+  "py": "solana_wallet_balances",
+  "description": "SOL balance and token holdings of any Solana address, with symbols, USD prices and values, largest first.",
+  "priceUsd": 0.01,
+  "required": [
+   "address"
+  ]
+ },
+ {
+  "id": "tech-stack-lookup",
+  "py": "tech_stack_lookup",
+  "description": "Detect the technologies a public website uses: CMS or site builder, JavaScript framework, CDN and hosting, web server, analytics and tag managers, advertising pixels, support widgets, payments, consent tools.",
+  "priceUsd": 0.005,
+  "required": []
+ },
+ {
+  "id": "ted-notices-search",
+  "py": "ted_notices_search",
+  "description": "Find recent EU public procurement notices by buyer country, CPV code, keyword and notice type.",
+  "priceUsd": 0.01,
+  "required": []
+ },
+ {
+  "id": "tender-feed",
+  "py": "tender_feed",
+  "description": "Search public tenders across TED (EU), Find a Tender (UK) and SAM.gov (US) in one normalised schema: title, buyer organisation, country, CPV codes, deadline, estimated value, procurement method and source link.",
+  "priceUsd": 0.02,
+  "required": []
+ },
+ {
+  "id": "url-metadata",
+  "py": "url_metadata",
+  "description": "Link-preview data for one or many public URLs: title, description, canonical URL, Open Graph and Twitter card fields, favicon, language, hreflang alternates, feed links and JSON-LD types.",
+  "priceUsd": 0.003,
+  "required": []
+ },
+ {
+  "id": "url-to-markdown",
+  "py": "url_to_markdown",
+  "description": "Fetch a public web page and return its main text as Markdown with title, headings, lists, tables and absolute links.",
+  "priceUsd": 0.003,
+  "required": [
+   "url"
+  ]
+ },
+ {
+  "id": "us-treasury-rates",
+  "py": "us_treasury_rates",
+  "description": "Monthly average interest rates on US Treasury marketable securities (bills, notes, bonds, TIPS, FRNs) Latest months first.",
+  "priceUsd": 0.003,
+  "required": []
+ },
+ {
+  "id": "wikipedia-summary",
+  "py": "wikipedia_summary",
+  "description": "Lead-section summary of a Wikipedia article by title and language: plain-text extract, short description, canonical URL and last-edit time.",
+  "priceUsd": 0.003,
+  "required": [
+   "title"
+  ]
+ }
+]

ambolt-0.1.0/ambolt.egg-info/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: ambolt
+Version: 0.1.0
+Summary: Client for the Ambolt pay-per-call data tools (x402, USDC): electricity, company registers, tenders, FX, DNS, on-chain facts.
+License: MIT
+Project-URL: Homepage, https://ambolt.dev
+Project-URL: Documentation, https://ambolt.dev/docs
+Project-URL: Source, https://github.com/ambolt/ambolt-mcp
+Keywords: x402,mcp,ai-agents,data-api,usdc
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ambolt
+
+Client for [Ambolt](https://ambolt.dev): dated, sourced data lookups as pay-per-call endpoints (x402, USDC). Failed calls are never charged.
+
+```python
+from ambolt import Ambolt
+
+ambolt = Ambolt(session=paying_session)  # a requests-compatible session that pays x402 challenges
+print(ambolt.iban_validate(iban="DK5000400440116243"))
+print(ambolt.call("dk-electricity-prices", area="DK1"))
+```
+
+Every function is also an MCP tool at `https://api.ambolt.dev/mcp`. Not financial, legal or tax advice.

ambolt-0.1.0/ambolt.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+ambolt/__init__.py
+ambolt/_generated.py
+ambolt.egg-info/PKG-INFO
+ambolt.egg-info/SOURCES.txt
+ambolt.egg-info/dependency_links.txt
+ambolt.egg-info/top_level.txt

ambolt-0.1.0/ambolt.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ambolt-0.1.0/ambolt.egg-info/top_level.txt

@@ -0,0 +1 @@
+ambolt

ambolt-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ambolt"
+version = "0.1.0"
+description = "Client for the Ambolt pay-per-call data tools (x402, USDC): electricity, company registers, tenders, FX, DNS, on-chain facts."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+keywords = ["x402", "mcp", "ai-agents", "data-api", "usdc"]
+
+classifiers = ["License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Intended Audience :: Developers"]
+
+[project.urls]
+Homepage = "https://ambolt.dev"
+Documentation = "https://ambolt.dev/docs"
+Source = "https://github.com/ambolt/ambolt-mcp"
+
+[tool.setuptools]
+packages = ["ambolt"]

ambolt-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+