agent-utils-extensions 0.1.0__py3-none-any.whl

agent_utils/extensions/__init__.py

@@ -0,0 +1,91 @@
+# SPDX-License-Identifier: MIT
+"""Thin MCP-over-HTTP client for the hosted agent_utils Extensions server.
+
+Extensions is the stateless half of agent_utils: exact math and unit
+conversion (general, electrical, chemistry, thermodynamics), all on one endpoint.
+
+This is a client, not the service - see https://agent-utils.ai.
+Zero dependencies: standard library only.
+"""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.request
+from typing import Any
+
+DEFAULT_ENDPOINT = "https://mcp.agent-utils.ai/extensions"
+STAGING_ENDPOINT = "https://mcp-staging.agent-utils.ai/extensions"
+USER_AGENT = "agent-utils-extensions-py/0.1.0"
+
+__all__ = ["AgentUtilsExtensions", "DEFAULT_ENDPOINT", "STAGING_ENDPOINT"]
+
+
+class AgentUtilsExtensions:
+    """Client for the agent_utils Extensions MCP server.
+
+    The same token works on both agent_utils servers (swarm and extensions) and
+    draws from one credit pool. Any secret works as a token - the first call
+    auto-provisions a free trial. See https://agent-utils.ai.
+    """
+
+    def __init__(self, token: str, endpoint: str = DEFAULT_ENDPOINT) -> None:
+        self._token = token
+        self._endpoint = endpoint
+        self._id = 0
+
+    def call(self, name: str, arguments: dict[str, Any] | None = None) -> Any:
+        """Call any MCP tool by name and return its result."""
+        self._id += 1
+        payload = json.dumps({"jsonrpc": "2.0", "id": self._id, "method": "tools/call",
+                              "params": {"name": name, "arguments": arguments or {}}}).encode()
+        req = urllib.request.Request(self._endpoint, data=payload, method="POST",
+                                     headers={"Authorization": f"Bearer {self._token}",
+                                              "Content-Type": "application/json",
+                                              # Cloudflare rejects urllib's default User-Agent (error 1010).
+                                              "User-Agent": USER_AGENT})
+        try:
+            with urllib.request.urlopen(req) as resp:
+                body = json.loads(resp.read())
+        except urllib.error.HTTPError as exc:  # pragma: no cover
+            raise RuntimeError(f"agent_utils HTTP {exc.code}: {exc.read().decode()}") from exc
+        if isinstance(body, dict) and body.get("error"):
+            raise RuntimeError(f"agent_utils: {body['error'].get('message', 'unknown error')}")
+        return body.get("result") if isinstance(body, dict) else body
+
+    def eval_expr(self, **kwargs: Any) -> Any:
+        return self.call("eval_expr", kwargs)
+
+    def convert(self, quantity: str, from_unit: str, to_unit: str, amount: float) -> Any:
+        """Convert `amount` between units of `quantity` (e.g. "length", "electric_potential")."""
+        return self.call("convert_" + quantity, {"from": from_unit, "to": to_unit, "amount": amount})
+
+    # --- account (also on swarm) ---------------------------------------------
+
+    def get_account(self) -> Any:
+        return self.call("get_account", {})
+
+    def list_api_keys(self, **kwargs: Any) -> Any:
+        return self.call("list_api_keys", kwargs)
+
+    def create_api_key(self, **kwargs: Any) -> Any:
+        return self.call("create_api_key", kwargs)
+
+    def revoke_api_key(self, **kwargs: Any) -> Any:
+        return self.call("revoke_api_key", kwargs)
+
+    def list_payments(self, **kwargs: Any) -> Any:
+        return self.call("list_payments", kwargs)
+
+    def settle_balance(self, **kwargs: Any) -> Any:
+        return self.call("settle_balance", kwargs)
+
+    def submit_feature_request(self, **kwargs: Any) -> Any:
+        return self.call("submit_feature_request", kwargs)
+
+    def submit_exit_feedback(self, **kwargs: Any) -> Any:
+        return self.call("submit_exit_feedback", kwargs)
+
+    def delete_account(self, **kwargs: Any) -> Any:
+        return self.call("delete_account", kwargs)

agent_utils_extensions-0.1.0.dist-info/METADATA

@@ -0,0 +1,78 @@
+Metadata-Version: 2.5
+Name: agent-utils-extensions
+Version: 0.1.0
+Summary: Thin client for the agent_utils Extensions MCP server - exact math and unit conversion for AI agents. One account spans both agent_utils servers.
+Project-URL: Homepage, https://agent-utils.ai
+Project-URL: Repository, https://github.com/agent-utils/agent-utils-extensions-py
+Author-email: AI Cortex LLC <support@agent-utils.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent-utils,ai-agents,claude,math,mcp,model-context-protocol,unit-conversion
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# agent-utils-extensions
+
+Thin Python client for the **agent_utils Extensions** server - stateless capabilities for AI agents over MCP: exact math and unit conversion.
+
+This is a client for a hosted commercial service ([agent-utils.ai](https://agent-utils.ai)), not the service itself. Zero dependencies (standard library only). Install name `agent-utils-extensions`; import `agent_utils.extensions` (a namespace package).
+
+## Install
+
+```bash
+pip install agent-utils-extensions
+```
+
+## Quickstart
+
+```python
+import os
+from agent_utils.extensions import AgentUtilsExtensions
+
+# Any secret works as a token; the first call auto-provisions a free trial.
+ext = AgentUtilsExtensions(token=os.environ["AGENT_UTILS_TOKEN"])
+
+ext.eval_expr(expr="2^10 + 1/3")
+ext.convert("electric_potential", "volt", "millivolt", 1.5)
+```
+
+## API
+
+**Math** - exact expression evaluation
+- `eval_expr(expr)`
+
+**Units** - 56 dimension-checked converters
+- `convert(quantity, from_unit, to_unit, amount)` - calls `convert_<quantity>`. Quantities: acceleration, amount_of_substance, angle, angular_velocity, area, capacitance, catalytic_activity, diffusion_coefficient, dynamic_viscosity, electric_charge, electric_current, electric_potential, electrical_conductance, electrical_resistance, electrical_resistivity, energy, force, frequency, heat_capacity, heat_flux_density, illuminance, inductance, information, information_rate, kinematic_viscosity, length, luminance, luminous_intensity, magnetic_flux, magnetic_flux_density, mass, mass_concentration, mass_density, mass_rate, molality, molar_concentration, molar_mass, molar_volume, moment_of_inertia, momentum, power, pressure, radioactivity, specific_heat_capacity, surface_tension, temperature, temperature_interval, thermal_conductance, thermal_conductivity, thermal_resistance, time, torque, velocity, volume, volume_rate, volumetric_heat_capacity
+
+**Account** (on both servers) - `get_account`, `list_api_keys`, `create_api_key`, `revoke_api_key`, `list_payments`, `settle_balance`, `submit_feature_request`, `submit_exit_feedback`, `delete_account`
+
+- `call(name, args)` - call any tool by name
+
+Valid unit strings for each quantity are listed in that tool's input schema (`tools/list`, no auth).
+
+Every response carries a `_meta` envelope with `account_status`, `op_cost`, and
+`credits_remaining`. The canonical, always-current reference is the server's
+[llms.txt](https://mcp.agent-utils.ai/llms.txt) (per service: `/docs/<service>`).
+
+Endpoint: `https://mcp.agent-utils.ai/extensions` (staging: `STAGING_ENDPOINT`, `https://mcp-staging.agent-utils.ai/extensions`).
+
+## One token, both servers
+
+agent_utils is two MCP servers on one account: **extensions** (this one) and **swarm** (memory, locks, task board, pub/sub, idempotency, webhook inbox). The same token works on both and draws from one credit pool. See the [agent-utils hub](https://github.com/agent-utils/agent-utils) for the full platform, and the TypeScript client [`@agent-utils/extensions`](https://github.com/agent-utils/agent-utils-extensions-ts).
+
+## Pricing
+
+1 credit = $0.00001. Trial: 1,000 credits, no card. Activation: $5 -> 500,000-credit limit. Terms: [mcp.agent-utils.ai/legal.txt](https://mcp.agent-utils.ai/legal.txt).
+
+## Contact
+
+Questions, bugs or account issues: support@agent-utils.ai
+
+## License
+
+MIT. The hosted agent_utils service is a separate commercial product and is not open-source.

agent_utils_extensions-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+agent_utils/extensions/__init__.py,sha256=jS_vyoEdb4ZC8Pp8LZoOgHHKJ3OqYAN0fjdWs-u2adw,3892
+agent_utils_extensions-0.1.0.dist-info/METADATA,sha256=t6-YCRV5tG9T28ierttbB2eusP9bsI3N7DmI88y51IE,4289
+agent_utils_extensions-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+agent_utils_extensions-0.1.0.dist-info/licenses/LICENSE,sha256=0ZMkJQ-RQW_bob3rCQSjv1PU-qYMZuVeB91Xc-tSpRk,1070
+agent_utils_extensions-0.1.0.dist-info/RECORD,,

agent_utils_extensions-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

agent_utils_extensions-0.1.0.dist-info/licenses/LICENSE

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