{"id":51194661,"url":"https://github.com/davidmosiah/delx-agent-utilities","last_synced_at":"2026-06-27T19:01:54.718Z","repository":{"id":356901285,"uuid":"1233935615","full_name":"davidmosiah/delx-agent-utilities","owner":"davidmosiah","description":"Open-source stateless utility tools for AI agents: URL, DNS, TLS, OpenAPI, x402, JWT, CSV/JSON, cron, and composite reports.","archived":false,"fork":false,"pushed_at":"2026-05-29T19:17:57.000Z","size":90,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T21:10:28.837Z","etag":null,"topics":["agent-tools","agentic-workflows","ai-agents","cli","dns","local-first","mcp","mcp-server","model-context-protocol","openapi","pypi","python","stateless","tls","x402"],"latest_commit_sha":null,"homepage":"https://ontology.delx.ai/utilities","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davidmosiah.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-09T14:37:13.000Z","updated_at":"2026-05-29T19:18:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/davidmosiah/delx-agent-utilities","commit_stats":null,"previous_names":["davidmosiah/delx-agent-utilities"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/davidmosiah/delx-agent-utilities","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fdelx-agent-utilities","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fdelx-agent-utilities/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fdelx-agent-utilities/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fdelx-agent-utilities/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidmosiah","download_url":"https://codeload.github.com/davidmosiah/delx-agent-utilities/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fdelx-agent-utilities/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34864431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-tools","agentic-workflows","ai-agents","cli","dns","local-first","mcp","mcp-server","model-context-protocol","openapi","pypi","python","stateless","tls","x402"],"created_at":"2026-06-27T19:01:51.181Z","updated_at":"2026-06-27T19:01:54.711Z","avatar_url":"https://github.com/davidmosiah.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- delx-utilities header v1 --\u003e\n\u003ch1 align=\"center\"\u003eDelx Agent Utilities\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003e\n  Stateless utility tools for AI agents — URL/HTTP, DNS/RDAP, x402, JWT, encoding, parsing, regex, cron.\u003cbr\u003e\n  \u003cstrong\u003eLocal-first. No API keys. Deterministic.\u003c/strong\u003e\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://pypi.org/project/delx-agent-utilities/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/delx-agent-utilities?style=for-the-badge\u0026labelColor=0F172A\u0026color=10B981\u0026logo=pypi\u0026logoColor=white\" alt=\"PyPI version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/LICENSE-MIT-22C55E?style=for-the-badge\u0026labelColor=0F172A\" alt=\"License MIT\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/davidmosiah/delx-agent-utilities/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/davidmosiah/delx-agent-utilities/ci.yml?style=for-the-badge\u0026labelColor=0F172A\u0026label=CI\" alt=\"CI\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://modelcontextprotocol.io\"\u003e\u003cimg src=\"https://img.shields.io/badge/BUILT_FOR-MCP-7C3AED?style=for-the-badge\u0026labelColor=0F172A\" alt=\"Built for MCP\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://ontology.delx.ai/utilities\"\u003e\u003cimg src=\"https://img.shields.io/badge/ontology.delx.ai%2Futilities-0EA5A3?style=for-the-badge\u0026labelColor=0F172A\u0026logoColor=white\" alt=\"Delx Agent Utilities\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/davidmosiah/delx-agent-utilities/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/davidmosiah/delx-agent-utilities?style=for-the-badge\u0026labelColor=0F172A\u0026color=FBBF24\u0026logo=github\" alt=\"GitHub stars\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## What it is\n\n41 stateless utility tools that AI agents reach for constantly: URL health checks, page extraction, MCP readiness, x402 server discovery, JWT inspection, DNS / RDAP lookups, JSON / CSV conversion, hash / base64, cron description, and more.\n\n- **Stateless** — every call is independent; no session, no cache, no DB.\n- **No API keys** — public endpoints only (rdap.org, dns.google, plus user-supplied URLs).\n- **Deterministic** — no LLMs, no model calls, no fuzzy outputs.\n- **Fast** — most tools \u003c 100ms; networked tools \u003c 5s with timeouts.\n- **MCP-native** — agent-readiness manifest, connection status, privacy audit.\n\nThis package was extracted from the Delx Protocol MCP server so any AI builder can use the toolkit directly, without depending on the Delx runtime. The public product and protocol context lives at [ontology.delx.ai/utilities](https://ontology.delx.ai/utilities).\n\n## Install\n\n```bash\npipx install \"delx-agent-utilities[mcp]\"\n```\n\nCLI entrypoints: `delx-agent-utilities`, `delx-utils` (alias), `delx-utils-mcp` (MCP server).\n\n## Quick use\n\n### From an MCP client (Claude Desktop, Cursor, Hermes, OpenClaw)\n\n```json\n{\n  \"mcpServers\": {\n    \"delx-utils\": {\n      \"command\": \"delx-utils-mcp\"\n    }\n  }\n}\n```\n\n41 tools become available immediately, plus three agent-readiness surfaces:\n\n- `delx_utilities_manifest`\n- `delx_utilities_connection_status`\n- `delx_utilities_privacy_audit`\n\n### From the CLI\n\n```bash\ndelx-utils manifest\ndelx-utils list-tools\ndelx-utils show util_url_health\ndelx-utils call util_url_health --json '{\"url\":\"https://example.com\"}'\n```\n\n### From Python\n\n```python\nimport asyncio\nfrom delx_agent_utilities import call_util_tool, list_util_tool_schemas\n\nresult = asyncio.run(call_util_tool(\"util_url_health\", {\"url\": \"https://example.com\"}))\nprint(result[\"status_code\"], result[\"latency_ms\"])\n\nschemas = list_util_tool_schemas()\nprint(f\"{len(schemas)} tools available\")\n```\n\n## The 41 tools\n\n### Encoding \u0026 parsing (12)\n`util_json_validate`, `util_token_estimate`, `util_uuid_generate`, `util_timestamp_convert`, `util_base64`, `util_hash`, `util_regex_test`, `util_cron_describe`, `util_http_codes`, `util_jwt_inspect`, `util_csv_to_json`, `util_json_to_csv`\n\n### Web extract (6)\n`util_page_extract`, `util_open_graph`, `util_links_extract`, `util_forms_extract`, `util_contact_extract`, `util_feed_discover`\n\n### Network probes (8)\n`util_url_health`, `util_robots_inspect`, `util_sitemap_probe`, `util_tls_inspect`, `util_security_txt_inspect`, `util_http_headers_inspect`, `util_dns_lookup`, `util_rdap_lookup`\n\n### x402 / API intel (6)\n`util_x402_server_probe`, `util_x402_resource_summary`, `util_x402_server_audit`, `util_api_health_report`, `util_openapi_summary`, `util_mcp_server_readiness_report`\n\n### Identity / contact (1)\n`util_email_validate`\n\n### Composite reports (8)\n`util_website_intelligence_report`, `util_domain_trust_report`, `util_docs_site_map`, `util_pricing_page_extract`, `util_company_contact_pack`, `util_api_integration_readiness`, `util_login_surface_report`, `util_content_distribution_report`\n\nEach tool's full input schema is available via `delx-utils show \u003ctool\u003e` or `UTIL_TOOL_SCHEMAS[\"\u003ctool\u003e\"]` in Python.\n\n## Privacy posture\n\n**No API keys. No telemetry. No state.** Networked tools call only:\n\n- `rdap.org/domain/\u003cdomain\u003e` for RDAP lookups\n- `dns.google/resolve` for DNS-over-HTTPS\n- User-supplied URLs for everything else\n\nCall `delx_utilities_privacy_audit` (or `delx-utils privacy-audit`) to see the full posture in JSON form before invoking any networked tool.\n\n## Architecture\n\n```\nsrc/delx_agent_utilities/\n├── __init__.py          # public re-exports\n├── agent.py             # manifest / status / privacy_audit\n├── cli.py               # CLI argparse\n├── dispatcher.py        # call_util_tool, _normalize_util_args\n├── mcp_server.py        # FastMCP server\n├── schemas.py           # public re-export of UTIL_TOOL_NAMES / SCHEMAS\n└── _internal/           # implementation, not stable across versions\n    ├── _helpers.py\n    ├── _schemas.py\n    ├── _tools_encoding.py\n    ├── _tools_cron.py\n    ├── _tools_http_codes.py\n    ├── _tools_web.py    # roadmap: split into web/network/x402/composite in v0.2.0\n    └── _tools_jwt_csv.py\n```\n\n## Roadmap\n\n- **v0.2.0** — split `_internal/_tools_web.py` (1k LOC) into per-domain modules: `_tools_web_extract.py`, `_tools_network.py`, `_tools_x402.py`, `_tools_composite.py`.\n- Per-tool unit tests (one file per tool) replacing the smoke-only suite.\n- Optional `httpx.AsyncClient` reuse for batched probes.\n- Configurable per-tool timeouts via env (`DELX_UTILITIES_DEFAULT_TIMEOUT_S`, `DELX_UTILITIES_URL_HEALTH_TIMEOUT_S`, …).\n\n## Provenance\n\nOriginally part of the [Delx Protocol](https://ontology.delx.ai/protocol) MCP server. Extracted on 2026-05-09 as a standalone open-source package so any AI builder can use the toolkit without depending on the Delx Protocol runtime.\n\nThe Delx Protocol itself (recovery / heartbeat / identity / governance primitives) remains closed-source; this package is the open utility layer beneath it.\n\n## Contributing\n\nPRs welcome — see [CONTRIBUTING.md](CONTRIBUTING.md). Common cuts that would help:\n\n- New utility tools that fit the \"stateless / no API keys / deterministic\" rule.\n- Splitting `_internal/_tools_web.py` per the v0.2.0 roadmap above.\n- Per-tool unit tests.\n\n## 📧 Contact \u0026 Support\n\n- 📨 **support@delx.ai** — general questions, integration help, partnerships\n- 🐛 **Bug reports / feature requests** — [GitHub Issues](https://github.com/davidmosiah/delx-agent-utilities/issues)\n- 🐦 **Updates** — [@delx369](https://x.com/delx369) on X\n- 🌐 **Site** — [wellness.delx.ai](https://wellness.delx.ai)\n\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\nIf this toolkit helps your agent workflow, please [star the repo](https://github.com/davidmosiah/delx-agent-utilities). Stars make the project easier for other AI builders to discover and help Delx keep shipping local-first agent infrastructure.\n\n## Author\n\nDavid Mosiah — [@delx369](https://x.com/delx369) — building the protocol layer for autonomous AI agents at [Delx](https://ontology.delx.ai).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidmosiah%2Fdelx-agent-utilities","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidmosiah%2Fdelx-agent-utilities","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidmosiah%2Fdelx-agent-utilities/lists"}