fix(mcp): restore stdio server.py/run.py; fix README typo and Glama CMD

- Optional local Python stdio alongside .mcpb / bridge docs
- Dockerfile.glama: CMD server.py; README BASE_URL table fixed

Made-with: Cursor

Author: anhmtk

AGENTS.md

@@ -1,6 +1,6 @@
 # AgentShare — AI Agent Briefing
 
-**Repository:** [agentshare-mcp](https://github.com/anhmtk/agentshare-mcp) — stdio MCP server that proxies [Agent Price API](https://agentshare.dev) tools. **Implementation path:** `integrations/mcp_server/` (see `price_mcp.py`).
+**Repository:** [agentshare-mcp](https://github.com/anhmtk/agentshare-mcp) — reference **MCP tool** code and GEO/agent files for [Agent Price API](https://agentshare.dev). **Production MCP** is served at `https://agentshare.dev/mcp`; Claude Desktop ships as **`.mcpb`** (see **agent-price-api** `mcpb-bundle/`). **Implementation path:** `integrations/mcp_server/` (`price_mcp.py` mirrors the server app).
 
 ---
 
@@ -70,7 +70,7 @@ These are the **registered tool names** in this codebase. They map to REST as sh
 }
 ```
 
-Replace `YOUR_API_KEY` with your key. For **local stdio** (no `npx`), use `python` + `integrations/mcp_server/server.py` — see [README](README.md).
+Replace `YOUR_API_KEY` with your key. For **Claude Desktop**, prefer the **`.mcpb`** bundle; for **Cursor**, use **`node`** + `bridge.mjs` or optional **`python`** + `integrations/mcp_server/server.py` — see [README](README.md).
 
 **Streamable HTTP URL:** `https://agentshare.dev/mcp` (trailing slash optional for many clients).
 
@@ -89,5 +89,6 @@ Replace `YOUR_API_KEY` with your key. For **local stdio** (no `npx`), use `pytho
 |------|------|
 | `integrations/mcp_server/price_mcp.py` | Tool definitions and REST calls |
 | `integrations/mcp_server/mcp_tool_format.py` | Summary + JSON envelope, error mapping |
-| `integrations/mcp_server/server.py` | stdio entrypoint |
+| `integrations/mcp_server/server.py` | stdio entrypoint (optional; local Claude/Cursor) |
+| `integrations/mcp_server/run.py` | Launcher alias for `server.py` |
 | `examples/` | Minimal REST examples |

README.md

@@ -8,7 +8,7 @@
 
 ## Description
 
-**AgentShare** provides **structured marketplace prices and offers for AI agents** via a JSON **REST API** and **MCP** ([Streamable HTTP](https://agentshare.dev/mcp/)). This repository contains the **stdio MCP server** (Python) used with Claude Desktop, Cursor, and other MCP clients, plus minimal REST examples. The production API, pricing, and full docs live at **https://agentshare.dev**.
+**AgentShare** provides **structured marketplace prices and offers for AI agents** via a JSON **REST API** and **MCP** ([Streamable HTTP](https://agentshare.dev/mcp/)). This repository holds **reference Python tool code** (`integrations/mcp_server/`), **GEO/agent docs** (`AGENTS.md`, `llms.txt`, …), and **REST examples**. The live **`/mcp`** implementation and **`.mcpb`** bundle are maintained in **[agent-price-api](https://github.com/anhmtk/agent-price-api)** (`mcpb-bundle/agentshare-price-mcp`).
 
 All MCP tools are **read-only**: they fetch data from the AgentShare API and do not modify your accounts or remote marketplace listings.
 
@@ -43,66 +43,27 @@ All MCP tools are **read-only**: they fetch data from the AgentShare API and do
 
 ## Getting an API key
 
-To use this MCP server or the REST API, you need an API key. Visit [https://agentshare.dev/pricing](https://agentshare.dev/pricing) to get your free tier key (**100 requests / month** on the public free plan at time of writing — always confirm on the site).
+To use MCP or the REST API, you need an API key. Visit [https://agentshare.dev/pricing](https://agentshare.dev/pricing) to get your free tier key (**100 requests / month** on the public free plan at time of writing — always confirm on the site).
 
 ---
 
 ## Installation
 
-### Quick install (pip)
+**Recommended — Claude Desktop:** **`.mcpb`** from **[agent-price-api](https://github.com/anhmtk/agent-price-api)** → `mcpb-bundle/agentshare-price-mcp` → `mcpb pack`.
 
-```bash
-git clone https://github.com/anhmtk/agentshare-mcp.git
-cd agentshare-mcp
-pip install -r integrations/mcp_server/requirements.txt
-export API_KEY=your_api_key   # Windows: $env:API_KEY="..."
-# optional: export BASE_URL=https://agentshare.dev
-python integrations/mcp_server/server.py
-```
-
-Get a key: https://agentshare.dev/pricing
-
-### Claude Desktop (`claude_desktop_config.json`) — stdio
-
-Use a **local stdio** server (Python). Replace the path with the **absolute** path to `server.py` in *your* clone of this repo.
-
-```json
-{
-  "mcpServers": {
-    "agentshare": {
-      "command": "python",
-      "args": ["/ABSOLUTE/PATH/TO/agentshare-mcp/integrations/mcp_server/server.py"],
-      "env": {
-        "API_KEY": "your-api-key-here",
-        "BASE_URL": "https://agentshare.dev"
-      }
-    }
-  }
-}
-```
+**Cursor / IDE:** Node **`bridge.mjs`** (same as `.mcpb`) or **`npx mcp-remote`** with `--header X-API-Key:…` — see [`mcp-config.json`](mcp-config.json).
 
-- On Windows, prefer forward slashes in `args`, e.g. `D:/code/agentshare-mcp/integrations/mcp_server/server.py`.
-
-**Remote MCP (Streamable HTTP):** clients that support URL + API key headers can use `https://agentshare.dev/mcp/` with `X-API-Key` or `Authorization: Bearer`. Use **[`mcp-config.json`](mcp-config.json)** for **`npx mcp-remote`**. Details: [MCP Quickstart](https://agentshare.dev/docs) (section MCP).
-
-**Advanced — HTTP via `mcp-remote` (Node / npx):** if you use [`mcp-remote`](https://github.com/geelen/mcp-remote) to bridge HTTPS → stdio, pass your key with `--header` (see troubleshooting in [Cursor MCP setup](https://agentshare.dev/docs)); this repo does **not** publish an `npx agentshare-mcp` package.
-
-The official **Claude Desktop Extension** (`.mcpb`) uses a small Node **bridge** (see the **agent-price-api** repo, `mcpb-bundle/agentshare-price-mcp`) and does **not** rely on `mcp-remote`.
-
-### Clone & run stdio locally
+**Optional — Python stdio** (this repo), from clone root:
 
 ```bash
 pip install -r integrations/mcp_server/requirements.txt
 export API_KEY=your_api_key
-# optional: export BASE_URL=http://localhost:8000
 python integrations/mcp_server/server.py
 ```
 
-Same as `python integrations/mcp_server/run.py`. See [`integrations/mcp_server/README.md`](integrations/mcp_server/README.md) for tools and environment variables.
-
-### Claude Desktop Extension (`.mcpb`)
+Same as `python integrations/mcp_server/run.py`.
 
-A packaged extension (**AgentShare — Real-time Price & Offer MCP**) can be installed from the `.mcpb` built in the main **agent-price-api** repo (`mcpb-bundle/agentshare-price-mcp`). That bundle connects to `https://agentshare.dev/mcp` via a small Node bridge. See [MCP Quickstart](https://agentshare.dev/docs) on the site.
+**Glama:** use **`integrations/mcp_server/Dockerfile.glama`** (runs `server.py`).
 
 ---
 
@@ -112,11 +73,8 @@ A packaged extension (**AgentShare — Real-time Price & Offer MCP**) can be ins
 
 | Variable | Required | Default | Description |
 |----------|----------|---------|-------------|
-| `API_KEY` | For price tools | — | Sent as `X-API-Key` to the API |
-| `BASE_URL` | No | `https://agentshare.dev` | API base URL (e.g. local dev) |
-| `MCP_UPSTREAM_TIMEOUT_SEC` | No | `120` | HTTP timeout for upstream API calls |
-
-**Remote MCP (Streamable HTTP):** clients that support URL + headers can call `https://agentshare.dev/mcp/` with `X-API-Key` or `Authorization: Bearer`. Details: [docs](https://agentshare.dev/docs) (MCP section).
+| `API_KEY` | For price tools (REST / some clients) | — | Sent as `X-API-Key` to the API |
+| `BASE_URL` | No | `https://agentshare.dev` | API base URL |
 
 ---
 

integrations/mcp_server/README.md

@@ -14,6 +14,8 @@ export API_KEY=your_key
 python integrations/mcp_server/server.py
 ```
 
+Prefer **`.mcpb`** or **Node bridge** for Claude when you do not need Python stdio — see [README](../../README.md).
+
 ## Tools
 
 | Tool | Auth | Description |
@@ -30,4 +32,4 @@ python integrations/mcp_server/server.py
 
 ## Cursor Setup
 
-See [Cursor MCP setup](https://agentshare.dev/docs) (MCP section) for manual Cursor configuration steps.
+See [Cursor MCP setup](https://agentshare.dev/docs) (MCP section) or repo [README](../../README.md).

integrations/mcp_server/price_mcp.py

@@ -28,7 +28,7 @@
 
 
 def _load_dotenv() -> None:
-    """Load .env from mcp_server dir or project root (same as legacy server.py)."""
+    """Load .env from mcp_server dir or project root."""
     here = Path(__file__).resolve().parent
     project_root = here.parent.parent
     for p in (here / ".env", project_root / ".env"):

integrations/mcp_server/run.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 """Launcher for Agent Price API MCP server (stdio). Run from project root: python integrations/mcp_server/run.py"""
 import sys
 from pathlib import Path