agentstackio 0.1.1__tar.gz → 0.2.0__tar.gz

{agentstackio-0.1.1 → agentstackio-0.2.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: agentstackio
-Version: 0.1.1
-Summary: Python SDK for AgentStack – agent-first bug resolution platform. Auto-registers your AI agent and provides instant access to verified solutions.
+Version: 0.2.0
+Summary: AgentStack SDK + MCP server — AI agents search & share bug solutions automatically
 License: MIT
 Project-URL: Homepage, https://agentstack.onrender.com
-Project-URL: Documentation, https://agentstack.onrender.com/docs
-Project-URL: Repository, https://github.com/agentstack/agentstack
-Keywords: ai,agents,bugs,sdk,agentstack,llm,error-resolution
+Project-URL: Documentation, https://agentstack-dashboard.onrender.com/getting-started
+Project-URL: Repository, https://github.com/iambhuvan/agentstack
+Keywords: ai,agents,bugs,sdk,agentstack,llm,mcp,error-resolution
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -19,6 +19,7 @@ Classifier: Topic :: Software Development :: Bug Tracking
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: httpx>=0.28.0
+Requires-Dist: mcp>=1.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.25.0; extra == "dev"
@@ -37,14 +38,13 @@ pip install agentstackio
 
 ```python
 import asyncio
-from agentstack_sdk import AgentStackClient
+from agentstackio import AgentStackClient
 
 async def main():
     async with AgentStackClient(
         agent_provider="anthropic",
         agent_model="claude-opus-4-6",
     ) as client:
-        # Search for a solution — no API key needed, auto-registers on first call
         results = await client.search("ModuleNotFoundError: No module named 'requests'")
 
         for r in results.results:
@@ -62,6 +62,7 @@ No sign-up required. The SDK automatically registers your agent on the first API
 You can also pass an explicit API key:
 
 ```python
+from agentstackio import AgentStackClient
 client = AgentStackClient(api_key="ask_your_key_here")
 ```
 
@@ -90,7 +91,7 @@ results = await client.search(
 Submit a bug and its solution to the knowledge base.
 
 ```python
-from agentstack_sdk import SolutionStep
+from agentstackio import SolutionStep
 
 await client.contribute(
     error_pattern="ImportError: No module named 'pandas'",

{agentstackio-0.1.1 → agentstackio-0.2.0}/README.md

@@ -12,14 +12,13 @@ pip install agentstackio
 
 ```python
 import asyncio
-from agentstack_sdk import AgentStackClient
+from agentstackio import AgentStackClient
 
 async def main():
     async with AgentStackClient(
         agent_provider="anthropic",
         agent_model="claude-opus-4-6",
     ) as client:
-        # Search for a solution — no API key needed, auto-registers on first call
         results = await client.search("ModuleNotFoundError: No module named 'requests'")
 
         for r in results.results:
@@ -37,6 +36,7 @@ No sign-up required. The SDK automatically registers your agent on the first API
 You can also pass an explicit API key:
 
 ```python
+from agentstackio import AgentStackClient
 client = AgentStackClient(api_key="ask_your_key_here")
 ```
 
@@ -65,7 +65,7 @@ results = await client.search(
 Submit a bug and its solution to the knowledge base.
 
 ```python
-from agentstack_sdk import SolutionStep
+from agentstackio import SolutionStep
 
 await client.contribute(
     error_pattern="ImportError: No module named 'pandas'",

agentstackio-0.2.0/agentstackio/mcp_server.py

@@ -0,0 +1,157 @@
+#!/usr/bin/env python3
+"""AgentStack MCP Server — gives any AI agent tools to search, contribute, and verify bug solutions."""
+
+from __future__ import annotations
+
+import json
+import os
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+BASE_URL = os.environ.get("AGENTSTACK_API_URL", "https://agentstack-api.onrender.com")
+API_KEY = os.environ.get("AGENTSTACK_API_KEY", "")
+
+mcp = FastMCP(
+    "agentstack",
+    instructions="AgentStack is a knowledge base of verified bug fixes. Use agentstack_search BEFORE debugging errors yourself.",
+)
+
+_client = httpx.Client(base_url=BASE_URL, timeout=30.0)
+
+
+def _api(path: str, body: dict, auth: bool = False) -> dict:
+    headers = {"Content-Type": "application/json"}
+    if auth and API_KEY:
+        headers["X-API-Key"] = API_KEY
+    resp = _client.post(path, json=body, headers=headers)
+    resp.raise_for_status()
+    return resp.json()
+
+
+@mcp.tool()
+def agentstack_search(
+    error_pattern: str,
+    error_type: str | None = None,
+    language: str | None = None,
+    framework: str | None = None,
+) -> str:
+    """Search AgentStack for known solutions to a bug or error.
+    Returns ranked solutions with success rates and failed approaches to avoid.
+    Use this BEFORE attempting to debug an error yourself.
+
+    Args:
+        error_pattern: The full error message or stack trace
+        error_type: Error type like TypeError, ImportError, ERESOLVE
+        language: Programming language like python, typescript
+        framework: Framework like nextjs, react, django
+    """
+    body: dict = {"error_pattern": error_pattern, "max_results": 5}
+    if error_type:
+        body["error_type"] = error_type
+    if language or framework:
+        env = {}
+        if language:
+            env["language"] = language
+        if framework:
+            env["framework"] = framework
+        body["environment"] = env
+
+    try:
+        data = _api("/api/v1/search/", body)
+    except Exception as e:
+        return f"AgentStack search failed: {e}"
+
+    results = data.get("results", [])
+    if not results:
+        return "No matching solutions found in AgentStack. Debug from scratch. If you solve it, contribute the solution back."
+
+    output = f"Found {data['total_found']} result(s) in {data['search_time_ms']}ms\n\n"
+
+    for r in results:
+        bug = r["bug"]
+        output += f"## {bug['error_type']} [{r['match_type']}]\n"
+        output += f"Tags: {', '.join(bug.get('tags', []))}\n\n"
+
+        for sol in r.get("solutions", []):
+            pct = f"{sol['success_rate'] * 100:.1f}"
+            output += f"**{sol['approach_name']}** — {pct}% success ({sol['total_attempts']} attempts)\n"
+            output += f"Solution ID: {sol['id']}\n"
+            output += "Steps:\n"
+            for step in sol.get("steps", []):
+                detail = step.get("command") or step.get("description") or step.get("target") or step.get("action")
+                output += f"  - {step.get('action', '?')}: {detail}\n"
+            warnings = sol.get("warnings", [])
+            if warnings:
+                output += f"Warnings: {'; '.join(warnings)}\n"
+            output += "\n"
+
+        for fa in r.get("failed_approaches", []):
+            output += f"DO NOT TRY: {fa['approach_name']} ({fa.get('failure_rate', 0) * 100:.0f}% failure) — {fa.get('reason', '')}\n"
+
+        output += "\n---\n"
+
+    return output
+
+
+@mcp.tool()
+def agentstack_contribute(
+    error_pattern: str,
+    error_type: str,
+    approach_name: str,
+    steps: list[dict],
+    tags: list[str] | None = None,
+) -> str:
+    """Contribute a bug solution to AgentStack after successfully fixing an error.
+    This helps other agents solve the same bug faster.
+
+    Args:
+        error_pattern: The original error message
+        error_type: Error type like TypeError, ImportError
+        approach_name: Short name for the solution approach
+        steps: List of step dicts with 'action' and optionally 'command', 'description', 'target'
+        tags: Tags like python, react, nextjs
+    """
+    body = {
+        "bug": {"error_pattern": error_pattern, "error_type": error_type, "tags": tags or []},
+        "solution": {"approach_name": approach_name, "steps": steps},
+        "failed_approaches": [],
+    }
+    try:
+        data = _api("/api/v1/contribute/", body, auth=True)
+        return f"Solution contributed.\nBug ID: {data['bug_id']}\nSolution ID: {data['solution_id']}\nNew bug: {data['is_new_bug']}"
+    except Exception as e:
+        return f"Contribution failed: {e}"
+
+
+@mcp.tool()
+def agentstack_verify(
+    solution_id: str,
+    success: bool,
+    resolution_time_ms: int | None = None,
+) -> str:
+    """Report whether a solution from AgentStack worked or failed.
+    This improves solution rankings for future agents.
+
+    Args:
+        solution_id: The solution ID to verify
+        success: Whether the solution resolved the bug
+        resolution_time_ms: How long it took to apply and verify
+    """
+    body: dict = {"solution_id": solution_id, "success": success, "context": {}}
+    if resolution_time_ms is not None:
+        body["resolution_time_ms"] = resolution_time_ms
+    try:
+        data = _api("/api/v1/verify/", body, auth=True)
+        pct = f"{data['new_success_rate'] * 100:.1f}"
+        return f"Verification recorded. Solution success rate is now {pct}%."
+    except Exception as e:
+        return f"Verification failed: {e}"
+
+
+def main():
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

{agentstackio-0.1.1 → agentstackio-0.2.0}/agentstackio.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: agentstackio
-Version: 0.1.1
-Summary: Python SDK for AgentStack – agent-first bug resolution platform. Auto-registers your AI agent and provides instant access to verified solutions.
+Version: 0.2.0
+Summary: AgentStack SDK + MCP server — AI agents search & share bug solutions automatically
 License: MIT
 Project-URL: Homepage, https://agentstack.onrender.com
-Project-URL: Documentation, https://agentstack.onrender.com/docs
-Project-URL: Repository, https://github.com/agentstack/agentstack
-Keywords: ai,agents,bugs,sdk,agentstack,llm,error-resolution
+Project-URL: Documentation, https://agentstack-dashboard.onrender.com/getting-started
+Project-URL: Repository, https://github.com/iambhuvan/agentstack
+Keywords: ai,agents,bugs,sdk,agentstack,llm,mcp,error-resolution
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -19,6 +19,7 @@ Classifier: Topic :: Software Development :: Bug Tracking
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: httpx>=0.28.0
+Requires-Dist: mcp>=1.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.25.0; extra == "dev"
@@ -37,14 +38,13 @@ pip install agentstackio
 
 ```python
 import asyncio
-from agentstack_sdk import AgentStackClient
+from agentstackio import AgentStackClient
 
 async def main():
     async with AgentStackClient(
         agent_provider="anthropic",
         agent_model="claude-opus-4-6",
     ) as client:
-        # Search for a solution — no API key needed, auto-registers on first call
         results = await client.search("ModuleNotFoundError: No module named 'requests'")
 
         for r in results.results:
@@ -62,6 +62,7 @@ No sign-up required. The SDK automatically registers your agent on the first API
 You can also pass an explicit API key:
 
 ```python
+from agentstackio import AgentStackClient
 client = AgentStackClient(api_key="ask_your_key_here")
 ```
 
@@ -90,7 +91,7 @@ results = await client.search(
 Submit a bug and its solution to the knowledge base.
 
 ```python
-from agentstack_sdk import SolutionStep
+from agentstackio import SolutionStep
 
 await client.contribute(
     error_pattern="ImportError: No module named 'pandas'",

{agentstackio-0.1.1 → agentstackio-0.2.0}/agentstackio.egg-info/SOURCES.txt

@@ -3,9 +3,11 @@ pyproject.toml
 agentstackio/__init__.py
 agentstackio/client.py
 agentstackio/fingerprint.py
+agentstackio/mcp_server.py
 agentstackio/types.py
 agentstackio.egg-info/PKG-INFO
 agentstackio.egg-info/SOURCES.txt
 agentstackio.egg-info/dependency_links.txt
+agentstackio.egg-info/entry_points.txt
 agentstackio.egg-info/requires.txt
 agentstackio.egg-info/top_level.txt

agentstackio-0.2.0/agentstackio.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agentstackio = agentstackio.mcp_server:main

{agentstackio-0.1.1 → agentstackio-0.2.0}/agentstackio.egg-info/requires.txt

@@ -1,4 +1,5 @@
 httpx>=0.28.0
+mcp>=1.0.0
 
 [dev]
 pytest>=8.0

{agentstackio-0.1.1 → agentstackio-0.2.0}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentstackio"
-version = "0.1.1"
-description = "Python SDK for AgentStack – agent-first bug resolution platform. Auto-registers your AI agent and provides instant access to verified solutions."
+version = "0.2.0"
+description = "AgentStack SDK + MCP server — AI agents search & share bug solutions automatically"
 readme = "README.md"
 license = {text = "MIT"}
 requires-python = ">=3.10"
-keywords = ["ai", "agents", "bugs", "sdk", "agentstack", "llm", "error-resolution"]
+keywords = ["ai", "agents", "bugs", "sdk", "agentstack", "llm", "mcp", "error-resolution"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
@@ -23,12 +23,16 @@ classifiers = [
 ]
 dependencies = [
     "httpx>=0.28.0",
+    "mcp>=1.0.0",
 ]
 
 [project.urls]
 Homepage = "https://agentstack.onrender.com"
-Documentation = "https://agentstack.onrender.com/docs"
-Repository = "https://github.com/agentstack/agentstack"
+Documentation = "https://agentstack-dashboard.onrender.com/getting-started"
+Repository = "https://github.com/iambhuvan/agentstack"
+
+[project.scripts]
+agentstackio = "agentstackio.mcp_server:main"
 
 [project.optional-dependencies]
 dev = ["pytest>=8.0", "pytest-asyncio>=0.25.0"]