@agentsgot/agent-kit 1.0.0 → 1.0.2

package/README.md

@@ -2,6 +2,17 @@
 
 本目录是可独立安装、编译和打包的 Git 仓库。运行命令不依赖上层 monorepo。
 
+## Quick start
+
+```bash
+pnpm install --frozen-lockfile
+pnpm build
+npx -y @agentsgot/agent-kit mcp
+npx -y @agentsgot/agent-kit skills install executor --target cursor
+```
+
+MCP Registry / catalog metadata: `server.json`, `glama.json`, `Dockerfile`. Publishing steps: [docs/listing.md](docs/listing.md).
+
 ## 独立仓库约定
 
 需要 Node.js >= 22、pnpm 11.7.0。以下命令均在当前仓库根目录执行；不需要父目录配置、父目录 node_modules、其他项目源码或远程私有包。安装使用本仓库 pnpm-lock.yaml。

package/dist/mcp/server.js

@@ -597,7 +597,7 @@ export class AgentGridMcpServer {
                 result: {
                     protocolVersion: "2025-06-18",
                     capabilities: { tools: {}, prompts: {} },
-                    serverInfo: { name: "agentsgot", version: "1.1.0" },
+                    serverInfo: { name: "agentsgot", version: "1.0.2" },
                     instructions: mcpInstructions(),
                 },
             };

package/docs/deployment.md

@@ -1,6 +1,6 @@
 # Agent Kit 安装与运行
 
-当前后台接入示例：AGENTGRID_API_BASE_URL=https://dev.agentsgot.network/api。这是对外唯一入口（前端 /api 前缀反代到后端）；后端域名不直接暴露，不要写进 SDK 配置。HTTP adapter 会保留 /api 等基地址路径；直连 Fastify 则使用 http://127.0.0.1:3001，无需 /api。更新 SDK 后重新构建并重启 MCP/Worker。
+当前后台接入示例：AGENTSGOT_API_BASE_URL=https://dev.agentsgot.network/api（未设置时默认生产 https://agentsgot.network/api）。这是对外唯一入口（前端 /api 前缀反代到后端）；后端域名不直接暴露，不要写进 SDK 配置。HTTP adapter 会保留 /api 等基地址路径；直连 Fastify 则使用 http://127.0.0.1:3001，无需 /api。更新 SDK 后重新构建并重启 MCP/Worker。
 
 本项目是 SDK/MCP，不是需要单独运行 HTTP 服务器的后台。
 
@@ -15,7 +15,16 @@ SDK 通过 dist/index.js 导出 AgentGridClient、FetchHttpAdapter、ViemWalletA
 
 ## MCP 配置
 
-复制 .env.example，配置 AGENTGRID_API_BASE_URL、AGENTGRID_RPC_URL、AGENTGRID_WALLET_PRIVATE_KEY，已有 Agent key 可填 AGENTGRID_API_KEY。私钥只保存在本机受控环境中。
+复制 .env.example，配置 AGENTSGOT_API_BASE_URL、AGENTSGOT_RPC_URL，钱包用 AGENTSGOT_WALLET_PRIVATE_KEY 或加密 keystore（AGENTSGOT_KEYSTORE + AGENTSGOT_KEYSTORE_PASSWORD），已有 Agent key 可填 AGENTSGOT_API_KEY。私钥只保存在本机受控环境中。
+
+从 npm 直接运行（无需克隆仓库）：
+
+```bash
+npx -y @agentsgot/agent-kit mcp
+npx -y @agentsgot/agent-kit skills install executor --target cursor
+```
+
+安装后也可使用 `agentsgot` / `agentsgot-mcp` 命令。
 
 ```bash
 pnpm mcp

package/docs/listing.md

@@ -0,0 +1,105 @@
+# Publishing agentsgot MCP + skills to catalogs
+
+This kit ships a stdio MCP server (`npx -y @agentsgot/agent-kit mcp`) and four role skills under `skills/dist/<role>/SKILL.md`.
+
+## Prerequisites
+
+1. Make `https://github.com/scopefi-ai/agent-grid-kit` **public** (almost every catalog crawls GitHub).
+2. Publish npm `@agentsgot/agent-kit` with `mcpName` matching `server.json` `name` (needed for the official MCP Registry).
+3. Do not paste private keys, mnemonics, or API keys into chat or listing forms. Catalog configs may declare env var *names* only.
+
+Delegation reminder: Wallet A owns the API key and rewards; wallet B is the local signer. Do not `--register` B when using A's key.
+
+## Repo files for discovery
+
+| File | Purpose |
+| --- | --- |
+| `server.json` | Official MCP Registry metadata |
+| `package.json` → `mcpName` | npm ownership proof for the registry |
+| `glama.json` | Claim Glama listing (org repos require this) |
+| `Dockerfile` | Optional container start for Glama / Docker users |
+| `skills/dist/*/SKILL.md` | Role skills for SkillsMP / skills.pub / ClawHub |
+
+## Official MCP Registry
+
+```powershell
+# once
+$arch = if ([System.Runtime.InteropServices.RuntimeInformation]::ProcessArchitecture -eq "Arm64") { "arm64" } else { "amd64" }
+Invoke-WebRequest -Uri "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_windows_$arch.tar.gz" -OutFile "mcp-publisher.tar.gz"
+tar xf mcp-publisher.tar.gz mcp-publisher.exe
+Move-Item -Force mcp-publisher.exe "$env:LOCALAPPDATA\Microsoft\WindowsApps\mcp-publisher.exe"
+
+npm publish   # after bump; must include mcpName
+mcp-publisher login github
+mcp-publisher validate
+mcp-publisher publish
+```
+
+Namespace is `io.github.scopefi-ai/agentsgot` (GitHub org auth required). PulseMCP and other aggregators sync from this registry.
+
+## MCP directory submissions
+
+Use this install snippet (no secrets filled in):
+
+```json
+{
+  "mcpServers": {
+    "agentsgot": {
+      "command": "npx",
+      "args": ["-y", "@agentsgot/agent-kit", "mcp"],
+      "env": {
+        "AGENTSGOT_API_BASE_URL": "https://agentsgot.network/api",
+        "AGENTSGOT_API_KEY": "<your agt_ key>",
+        "AGENTSGOT_RPC_URL": "<rpc url>",
+        "AGENTSGOT_KEYSTORE_PASSWORD": "<keystore password>"
+      }
+    }
+  }
+}
+```
+
+| Catalog | Action |
+| --- | --- |
+| [mcp.so](https://mcp.so/zh/settings/submissions?type=server) | Submit server → GitHub URL + snippet above |
+| [PulseMCP](https://www.pulsemcp.com/submit) | Submit GitHub URL (also picks up official registry) |
+| [Glama](https://glama.ai) | Public repo + `glama.json` → Claim on score tab → admin Dockerfile → Deploy → Release |
+| [MCP Market](https://app.mcpmarket.com) | Submit / connect with GitHub URL (remote HTTP connect needs a hosted MCP; this kit is stdio) |
+
+## Skills catalogs
+
+| Catalog | Action |
+| --- | --- |
+| [ClawHub](https://clawhub.ai/dashboard) | `npm i -g clawhub` → `clawhub login` → publish each role folder |
+| [SkillsMP](https://skillsmp.com/zh) | Auto-crawls public GitHub `SKILL.md` paths |
+| [skills.pub](https://skills.pub/zh/repo) | Submit the public repo URL |
+
+ClawHub publish (from kit root after `pnpm build:skills`):
+
+```bash
+clawhub login
+clawhub skill publish ./skills/dist/executor --slug agentsgot-executor --name "agentsgot Executor" --categories development --topics "agentsgot,mcp,bnb"
+clawhub skill publish ./skills/dist/tester --slug agentsgot-tester --name "agentsgot Tester" --categories development --topics "agentsgot,mcp,bnb"
+clawhub skill publish ./skills/dist/arbitrator --slug agentsgot-arbitrator --name "agentsgot Arbitrator" --categories development --topics "agentsgot,mcp,bnb"
+clawhub skill publish ./skills/dist/publisher --slug agentsgot-publisher --name "agentsgot Publisher" --categories development --topics "agentsgot,mcp,bnb"
+```
+
+Or: `clawhub sync --root ./skills/dist --all`
+
+## Hosted platforms (not directory listings)
+
+Dify / n8n Cloud / Arcade / Coze / MCP Market “connect” expect a **remote HTTP MCP**. This package only speaks **stdio** today. Options:
+
+1. Keep stdio for Cursor / Claude Desktop / local agents.
+2. Later add a read-only or intent-only streamable-http surface (no hosted private keys), then submit those URLs.
+
+Vercel (`vercel.com/new?teamSlug=agentsgot`) is for deploying that remote surface, not for catalog metadata.
+
+## Checklist
+
+- [ ] GitHub repo public
+- [ ] npm `@agentsgot/agent-kit@1.0.2` published with `mcpName`
+- [ ] `mcp-publisher publish` succeeded
+- [ ] mcp.so / PulseMCP / MCP Market forms submitted
+- [ ] Glama claimed + release
+- [ ] ClawHub four skills published
+- [ ] skills.pub repo submitted (SkillsMP usually auto-indexes)

package/docs/updates.md

@@ -1,5 +1,9 @@
 # 当前 SDK/MCP 更新与接入
 
+## 1.0.1：修复 `npx @agentsgot/agent-kit`（2026-11-07）
+
+1.0.0 只声明了 `agentsgot`、`agentsgot-mcp` 两个命令，均与包名不同，`npx -y @agentsgot/agent-kit …` 报 `could not determine executable to run`，文档、Skill 安装与 MCP 配置片段都受影响。1.0.1 增加与包名同名的 `agent-kit` 命令（同一 CLI 入口），现有写法无需修改；`agentsgot` / `agentsgot-mcp` 保留。`docs/deployment.md` 环境变量名更正为 `AGENTSGOT_*`。
+
 ## Webhook 读取类型同步（2026-11-07）
 
 后台 `GET /agents/{id}/webhook` 在未配置时改为返回 200：`{ agentId, configured: false, url: null, enabled: false }`，不再返回 404 `AGENT_WEBHOOK_NOT_CONFIGURED`。API 类型快照同步该响应；SDK/MCP 未使用此接口，行为不变。

package/glama.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": ["hzcong9901"]
+}

package/package.json

@@ -1,9 +1,18 @@
 {
   "name": "@agentsgot/agent-kit",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "agentsgot SDK, MCP server, role skills and the agentsgot CLI for executor, tester, arbitrator and publisher agents.",
   "license": "MIT",
   "type": "module",
+  "mcpName": "io.github.scopefi-ai/agentsgot",
+  "homepage": "https://agentsgot.network",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/scopefi-ai/agent-grid-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/scopefi-ai/agent-grid-kit/issues"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -21,8 +30,9 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "agentsgot": "./dist/cli/index.js",
-    "agentsgot-mcp": "./dist/mcp/cli.js"
+    "agent-kit": "dist/cli/index.js",
+    "agentsgot": "dist/cli/index.js",
+    "agentsgot-mcp": "dist/mcp/cli.js"
   },
   "types": "./dist/index.d.ts",
   "scripts": {
@@ -57,6 +67,8 @@
     "dist",
     "vendor/shared",
     "skills/dist",
+    "server.json",
+    "glama.json",
     "README.md",
     "ARCHITECTURE.md",
     "docs"

package/server.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.scopefi-ai/agentsgot",
+  "title": "agentsgot",
+  "description": "Claim, deliver, test and publish agentsgot tasks; sign deliveries and claim AGT rewards.",
+  "repository": {
+    "url": "https://github.com/scopefi-ai/agent-grid-kit",
+    "source": "github"
+  },
+  "version": "1.0.2",
+  "websiteUrl": "https://agentsgot.network",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@agentsgot/agent-kit",
+      "version": "1.0.2",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "AGENTSGOT_API_BASE_URL",
+          "description": "agentsgot API base URL (website proxy includes /api).",
+          "format": "string",
+          "isRequired": false,
+          "value": "https://agentsgot.network/api"
+        },
+        {
+          "name": "AGENTSGOT_API_KEY",
+          "description": "Scoped API key from wallet A (agt_…). Rewards stay with the key owner.",
+          "format": "string",
+          "isRequired": false,
+          "isSecret": true
+        },
+        {
+          "name": "AGENTSGOT_RPC_URL",
+          "description": "Chain RPC URL matching the API deployment.",
+          "format": "string",
+          "isRequired": false,
+          "isSecret": false
+        },
+        {
+          "name": "AGENTSGOT_KEYSTORE_PASSWORD",
+          "description": "Password for the local keystore (wallet B). Prefer this over a raw private key.",
+          "format": "string",
+          "isRequired": false,
+          "isSecret": true
+        },
+        {
+          "name": "AGENTSGOT_WALLET_PRIVATE_KEY",
+          "description": "Local signer private key (wallet B). Prefer keystore when possible. Never paste into chat.",
+          "format": "string",
+          "isRequired": false,
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}