agent-utils-extensions 0.1.0__tar.gz

agent_utils_extensions-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,40 @@
+name: release
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Check tag matches version
+        run: |
+          version=$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')
+          if [ "v$version" != "$GITHUB_REF_NAME" ]; then
+            echo "tag $GITHUB_REF_NAME does not match pyproject version $version"
+            exit 1
+          fi
+      - run: python -m pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

agent_utils_extensions-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+build/
+dist/
+*.egg-info/
+.venv/
+.DS_Store

agent_utils_extensions-0.1.0/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.

agent_utils_extensions-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,60 @@
+# 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/llms-install.md

@@ -0,0 +1,103 @@
+# Install - instructions for an AI agent
+
+**Nothing to clone, build, or run.** agent_utils Extensions is a *hosted* MCP server at
+`https://mcp.agent-utils.ai/extensions`. Installing it means pointing your MCP client at that URL with a
+Bearer token. There is no signup, no dashboard, no API-key request, and no payment card.
+
+If you are looking for a package to launch as a local stdio server, stop - this is a remote
+(Streamable HTTP) server. The npm/PyPI package below is an optional convenience client, not
+the server.
+
+## 1. Generate a token
+
+The token *is* the account. Any sufficiently random secret works, and the first call
+auto-provisions a free trial (1,000 credits).
+
+```bash
+TOKEN=sk_$(openssl rand -hex 32)
+echo "$TOKEN"   # save this - losing it means losing the account and its data
+```
+
+## 2. Register the server
+
+**Claude Code** - one command:
+
+```bash
+claude mcp add --scope user --transport http agent-utils-extensions https://mcp.agent-utils.ai/extensions \
+  --header "Authorization: Bearer $TOKEN"
+```
+
+**Cline / Cursor / Windsurf** - add to the MCP settings JSON:
+
+```json
+{
+  "mcpServers": {
+    "agent-utils-extensions": {
+      "url": "https://mcp.agent-utils.ai/extensions",
+      "headers": { "Authorization": "Bearer sk_REPLACE_WITH_YOUR_TOKEN" }
+    }
+  }
+}
+```
+
+## 3. Verify before spending anything
+
+`tools/list` needs **no authentication**, so reachability can be confirmed before the first
+billed call:
+
+```bash
+curl -s -X POST https://mcp.agent-utils.ai/extensions \
+  -H 'Content-Type: application/json' \
+  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
+```
+
+Expect 66 tools: math and units (general, electrical, chemistry, thermodynamics), plus the 9 shared account tools
+(`get_account`, `create_api_key`, `list_api_keys`, `revoke_api_key`, `list_payments`,
+`settle_balance`, `submit_feature_request`, `submit_exit_feedback`).
+
+## 4. Confirm the account
+
+`get_account` is free - it creates the trial account and returns its state:
+
+```bash
+curl -s -X POST https://mcp.agent-utils.ai/extensions \
+  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
+  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_account","arguments":{}}}'
+```
+
+A successful response means installation is complete.
+
+## Optional: the client library
+
+```bash
+pip install agent-utils-extensions
+```
+
+See `README.md` in this repo for the API.
+
+## One token, both servers
+
+agent_utils is two MCP servers: **swarm** (`https://mcp.agent-utils.ai/swarm` - memory, mutex,
+task board, pub/sub, idempotency, webhook inbox) and **extensions**
+(`https://mcp.agent-utils.ai/extensions` - math, units). The same token works on
+both and draws from a single credit pool. To add the other one, repeat step 2 with
+`agent-utils-swarm`, `https://mcp.agent-utils.ai/swarm`, and **the same token**.
+
+## Cost
+
+1 credit = $0.00001. Trial: 1,000 credits, no card. A one-time $5 activation raises the limit
+to 500,000 credits for the whole account. `get_account`, `settle_balance`, and
+`submit_exit_feedback` are free. Terms: <https://mcp.agent-utils.ai/legal.txt>.
+
+## Troubleshooting
+
+- **HTTP 401** - the `Authorization` header is missing or malformed. It must be exactly
+  `Bearer <token>`.
+- **HTTP 403 "error code: 1010"** - Cloudflare rejected your HTTP client's default
+  User-Agent (Python's `urllib` is blocked). Send any descriptive `User-Agent` header.
+- **No tools listed / 404** - you are probably POSTing to the wrong path. The endpoint is
+  `/extensions`, not the domain root or `/mcp`.
+- **"Key already exists" on a write** - services distinguish create from update. Check the
+  tool description returned by `tools/list`; it names the right tool.
+- **Authoritative reference** - the server's own spec is always current:
+  <https://mcp.agent-utils.ai/llms.txt>.

agent_utils_extensions-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agent-utils-extensions"
+version = "0.1.0"
+description = "Thin client for the agent_utils Extensions MCP server - exact math and unit conversion for AI agents. One account spans both agent_utils servers."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "AI Cortex LLC", email = "support@agent-utils.ai" }]
+keywords = ["mcp", "model-context-protocol", "ai-agents", "math", "unit-conversion", "claude", "agent-utils"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://agent-utils.ai"
+Repository = "https://github.com/agent-utils/agent-utils-extensions-py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agent_utils"]

agent_utils_extensions-0.1.0/src/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)