agent-tools-mcp 0.1.0__tar.gz

agent_tools_mcp-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+.env
+.DS_Store
+.coverage
+.pytest_cache/

agent_tools_mcp-0.1.0/LICENSE

@@ -0,0 +1,16 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+Copyright 2026 JoursBleu
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License. You may obtain a copy of the
+License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

agent_tools_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: agent-tools-mcp
+Version: 0.1.0
+Summary: Search and call x402 paid services from any MCP-compatible agent (Claude, Cursor, Cline).
+Project-URL: Homepage, https://agent-tools.cloud
+Project-URL: Repository, https://github.com/JoursBleu/agent-tools-mcp
+Project-URL: Issues, https://github.com/JoursBleu/agent-tools-mcp/issues
+Project-URL: Registry, https://registry.modelcontextprotocol.io/
+Author-email: JoursBleu <kangletian@hotmail.com>
+License: Apache-2.0
+License-File: LICENSE
+Keywords: agent,agent-tools,crypto,directory,mcp,model-context-protocol,web3,x402
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.2.0
+Description-Content-Type: text/markdown
+
+# agent-tools-mcp
+
+[![MCP](https://img.shields.io/badge/MCP-Server-blue)](https://modelcontextprotocol.io)
+[![PyPI](https://img.shields.io/pypi/v/agent-tools-mcp)](https://pypi.org/project/agent-tools-mcp/)
+[![License](https://img.shields.io/badge/License-Apache_2.0-green.svg)](https://opensource.org/licenses/Apache-2.0)
+
+Discover and call **x402 paid services** from any MCP-compatible agent (Claude, Cursor, Cline, Continue, …).
+
+Backed by [agent-tools.cloud](https://agent-tools.cloud), an open directory of 400+ x402 paid APIs (`awesome-x402`, `x402.org/ecosystem`, …).
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `search(intent, top_k, max_price_usd, category)` | Natural-language search across the directory |
+| `get(slug)` | Full details (URL, price, call template) of a service |
+| `list_categories()` | Browse categories |
+| `stats()` | Directory size & health snapshot |
+
+## Quick Start
+
+### Claude Code CLI
+
+```bash
+claude mcp add agent-tools -- uvx agent-tools-mcp
+```
+
+### Claude Desktop / Cursor / Cline
+
+Add to your MCP config (`~/.config/Claude/claude_desktop_config.json`, `~/.cursor/mcp.json`, …):
+
+```json
+{
+  "mcpServers": {
+    "agent-tools": {
+      "command": "uvx",
+      "args": ["agent-tools-mcp"]
+    }
+  }
+}
+```
+
+### Remote (no install)
+
+Most clients also accept a `url`-based remote MCP server:
+
+```json
+{
+  "mcpServers": {
+    "agent-tools": { "url": "https://agent-tools.cloud/mcp/v2" }
+  }
+}
+```
+
+### From source
+
+```bash
+pip install agent-tools-mcp        # or `uv tool install agent-tools-mcp`
+agent-tools-mcp                    # stdio server, ready for an MCP client
+```
+
+## Environment Variables
+
+| Var | Default | Purpose |
+|---|---|---|
+| `AGENT_TOOLS_API_BASE` | `https://agent-tools.cloud` | Point at a different deployment (e.g. self-hosted) |
+| `AGENT_TOOLS_LOG_LEVEL` | `INFO` | Server log level (stderr only) |
+| `AGENT_TOOLS_HTTP_LOG_LEVEL` | `WARNING` | httpx/httpcore log level |
+
+## Debugging
+
+```bash
+# Probe with the official MCP Inspector
+npx -y @modelcontextprotocol/inspector uvx agent-tools-mcp
+
+# Or raw JSON-RPC
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | uvx agent-tools-mcp
+```
+
+## License
+
+Apache-2.0. See [LICENSE](LICENSE).
+
+## Related
+
+- Directory site: <https://agent-tools.cloud>
+- x402 spec: <https://x402.org>
+- MCP spec: <https://modelcontextprotocol.io>

agent_tools_mcp-0.1.0/README.md

@@ -0,0 +1,88 @@
+# agent-tools-mcp
+
+[![MCP](https://img.shields.io/badge/MCP-Server-blue)](https://modelcontextprotocol.io)
+[![PyPI](https://img.shields.io/pypi/v/agent-tools-mcp)](https://pypi.org/project/agent-tools-mcp/)
+[![License](https://img.shields.io/badge/License-Apache_2.0-green.svg)](https://opensource.org/licenses/Apache-2.0)
+
+Discover and call **x402 paid services** from any MCP-compatible agent (Claude, Cursor, Cline, Continue, …).
+
+Backed by [agent-tools.cloud](https://agent-tools.cloud), an open directory of 400+ x402 paid APIs (`awesome-x402`, `x402.org/ecosystem`, …).
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `search(intent, top_k, max_price_usd, category)` | Natural-language search across the directory |
+| `get(slug)` | Full details (URL, price, call template) of a service |
+| `list_categories()` | Browse categories |
+| `stats()` | Directory size & health snapshot |
+
+## Quick Start
+
+### Claude Code CLI
+
+```bash
+claude mcp add agent-tools -- uvx agent-tools-mcp
+```
+
+### Claude Desktop / Cursor / Cline
+
+Add to your MCP config (`~/.config/Claude/claude_desktop_config.json`, `~/.cursor/mcp.json`, …):
+
+```json
+{
+  "mcpServers": {
+    "agent-tools": {
+      "command": "uvx",
+      "args": ["agent-tools-mcp"]
+    }
+  }
+}
+```
+
+### Remote (no install)
+
+Most clients also accept a `url`-based remote MCP server:
+
+```json
+{
+  "mcpServers": {
+    "agent-tools": { "url": "https://agent-tools.cloud/mcp/v2" }
+  }
+}
+```
+
+### From source
+
+```bash
+pip install agent-tools-mcp        # or `uv tool install agent-tools-mcp`
+agent-tools-mcp                    # stdio server, ready for an MCP client
+```
+
+## Environment Variables
+
+| Var | Default | Purpose |
+|---|---|---|
+| `AGENT_TOOLS_API_BASE` | `https://agent-tools.cloud` | Point at a different deployment (e.g. self-hosted) |
+| `AGENT_TOOLS_LOG_LEVEL` | `INFO` | Server log level (stderr only) |
+| `AGENT_TOOLS_HTTP_LOG_LEVEL` | `WARNING` | httpx/httpcore log level |
+
+## Debugging
+
+```bash
+# Probe with the official MCP Inspector
+npx -y @modelcontextprotocol/inspector uvx agent-tools-mcp
+
+# Or raw JSON-RPC
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | uvx agent-tools-mcp
+```
+
+## License
+
+Apache-2.0. See [LICENSE](LICENSE).
+
+## Related
+
+- Directory site: <https://agent-tools.cloud>
+- x402 spec: <https://x402.org>
+- MCP spec: <https://modelcontextprotocol.io>

agent_tools_mcp-0.1.0/agent_tools_mcp/__init__.py

@@ -0,0 +1,5 @@
+"""agent-tools-mcp — Discover and call x402 paid services from any MCP agent.
+
+Homepage: https://agent-tools.cloud
+"""
+__version__ = "0.1.0"

agent_tools_mcp-0.1.0/agent_tools_mcp/__main__.py

@@ -0,0 +1,33 @@
+"""Entry point: `agent-tools-mcp` (CLI script) or `python -m agent_tools_mcp`.
+
+Defaults to stdio transport so MCP clients (Claude Desktop, Cursor, Cline) can
+spawn this process directly via the `command` field in their config.
+"""
+from __future__ import annotations
+
+import logging
+import os
+import sys
+
+from .server import build_server
+
+
+def main() -> None:
+    # CRITICAL: every log must go to stderr; stdout is reserved for JSON-RPC.
+    logging.basicConfig(
+        stream=sys.stderr,
+        level=os.environ.get("AGENT_TOOLS_LOG_LEVEL", "INFO"),
+        format="%(asctime)s %(levelname)s %(name)s: %(message)s",
+    )
+    # Mute noisy libraries by default; opt in via env if debugging.
+    for noisy in ("httpx", "httpcore", "urllib3"):
+        logging.getLogger(noisy).setLevel(
+            os.environ.get("AGENT_TOOLS_HTTP_LOG_LEVEL", "WARNING")
+        )
+
+    server = build_server()
+    server.run()  # stdio transport by default
+
+
+if __name__ == "__main__":
+    main()

agent_tools_mcp-0.1.0/agent_tools_mcp/server.py

@@ -0,0 +1,114 @@
+"""Stdio MCP server exposing the agent-tools.cloud x402 directory.
+
+Tools:
+- search(intent, top_k, max_price_usd)  - natural-language service discovery
+- get(slug)                              - full details + call template
+- list_categories()                      - browse by category
+
+Reads `AGENT_TOOLS_API_BASE` env var (default https://agent-tools.cloud).
+"""
+from __future__ import annotations
+
+import logging
+import os
+from typing import Any
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+log = logging.getLogger("agent_tools_mcp")
+
+DEFAULT_API_BASE = "https://agent-tools.cloud"
+DEFAULT_TIMEOUT = 15.0
+
+
+def _api_base() -> str:
+    return os.environ.get("AGENT_TOOLS_API_BASE", DEFAULT_API_BASE).rstrip("/")
+
+
+def _user_agent() -> str:
+    from . import __version__
+    return f"agent-tools-mcp/{__version__} (+https://github.com/JoursBleu/agent-tools-mcp)"
+
+
+def build_server() -> FastMCP:
+    mcp = FastMCP(
+        name="agent-tools",
+        instructions=(
+            "Use these tools to find and inspect x402 paid services from the "
+            "agent-tools.cloud directory. Call `search` first with a natural "
+            "language intent, then `get` to fetch full call details."
+        ),
+    )
+
+    @mcp.tool()
+    async def search(
+        intent: str,
+        top_k: int = 5,
+        max_price_usd: float | None = None,
+        category: str | None = None,
+    ) -> dict[str, Any]:
+        """Find x402 paid services matching a natural-language intent.
+
+        Args:
+            intent: What the agent wants to do, in plain English or Chinese
+                (e.g. "fetch user tweets", "check on-chain whale activity").
+            top_k: Max number of services to return (default 5, max 25).
+            max_price_usd: Hard upper bound on per-call price in USD.
+            category: Optional category filter (see `list_categories`).
+        """
+        top_k = max(1, min(int(top_k), 25))
+        params: dict[str, Any] = {"q": intent, "limit": top_k}
+        if category:
+            params["category"] = category
+        async with httpx.AsyncClient(
+            timeout=DEFAULT_TIMEOUT, headers={"User-Agent": _user_agent()}
+        ) as cx:
+            r = await cx.get(f"{_api_base()}/api/v1/search", params=params)
+            r.raise_for_status()
+            data = r.json()
+
+        items = data.get("items") or data.get("services") or []
+        if max_price_usd is not None:
+            items = [
+                s for s in items
+                if (s.get("price_usd") is None) or float(s["price_usd"]) <= max_price_usd
+            ]
+        return {
+            "intent": intent,
+            "count": len(items[:top_k]),
+            "items": items[:top_k],
+        }
+
+    @mcp.tool()
+    async def get(slug: str) -> dict[str, Any]:
+        """Get full details (URL, price, schema, call template) of a service by slug."""
+        async with httpx.AsyncClient(
+            timeout=DEFAULT_TIMEOUT, headers={"User-Agent": _user_agent()}
+        ) as cx:
+            r = await cx.get(f"{_api_base()}/api/v1/services/{slug}")
+            r.raise_for_status()
+            return r.json()
+
+    @mcp.tool()
+    async def list_categories() -> dict[str, Any]:
+        """List all available service categories in the directory."""
+        async with httpx.AsyncClient(
+            timeout=DEFAULT_TIMEOUT, headers={"User-Agent": _user_agent()}
+        ) as cx:
+            r = await cx.get(f"{_api_base()}/api/v1/categories")
+            r.raise_for_status()
+            return r.json()
+
+    @mcp.tool()
+    async def stats() -> dict[str, Any]:
+        """High-level stats about the directory: total services, healthy count, sources."""
+        async with httpx.AsyncClient(
+            timeout=DEFAULT_TIMEOUT, headers={"User-Agent": _user_agent()}
+        ) as cx:
+            r = await cx.get(f"{_api_base()}/api/v1/stats")
+            r.raise_for_status()
+            return r.json()
+
+    log.info("agent-tools-mcp server built (api_base=%s)", _api_base())
+    return mcp

agent_tools_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["hatchling>=1.24"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agent-tools-mcp"
+version = "0.1.0"
+description = "Search and call x402 paid services from any MCP-compatible agent (Claude, Cursor, Cline)."
+readme = "README.md"
+license = { text = "Apache-2.0" }
+requires-python = ">=3.10"
+authors = [{ name = "JoursBleu", email = "kangletian@hotmail.com" }]
+keywords = ["mcp", "model-context-protocol", "x402", "agent-tools", "agent", "crypto", "web3", "directory"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: Apache Software License",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+  "mcp>=1.2.0",
+  "httpx>=0.27",
+]
+
+[project.urls]
+Homepage     = "https://agent-tools.cloud"
+Repository   = "https://github.com/JoursBleu/agent-tools-mcp"
+Issues       = "https://github.com/JoursBleu/agent-tools-mcp/issues"
+Registry     = "https://registry.modelcontextprotocol.io/"
+
+[project.scripts]
+agent-tools-mcp = "agent_tools_mcp.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["agent_tools_mcp"]