@agent-proxy-kit/puraroute-mcp-server 0.0.0-stage → 0.1.1

package/DISCLOSURE

@@ -0,0 +1 @@
+PuraRoute provides a local MCP server for authorized customers to inspect proxy accounts, obtain connection settings, and manage proxy resources through their approved business API. Proxy connectivity and account operations can have security-sensitive uses. Use this package only with accounts and systems you are authorized to manage. For support, see https://puraroute.com.

package/LICENSE

@@ -0,0 +1,15 @@
+PuraRoute Agent Package Use Terms
+
+The publisher grants a person or organization authorized to use PuraRoute
+services a limited, non-exclusive, non-transferable permission to install and
+use this package solely to access those services through the approved business
+API. This permission lasts only while that authorization remains in effect.
+
+You may not redistribute, sublicense, sell, or make this package available as
+a standalone product or service without separate written permission, except
+where applicable law permits. All rights not expressly granted are reserved.
+
+This package is provided "as is" to the extent permitted by applicable law.
+Service access, support, and permitted account activity remain subject to the
+terms applicable to your PuraRoute account. For support, see
+https://puraroute.com.

package/README.md

@@ -1,3 +1,20 @@
-# Temporary Holding Version
+# PuraRoute Agent
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+This one npm package contains a local stdio MCP server and the PuraRoute Agent Skill. npm places both on disk; your Agent client still needs to register the MCP launcher and load the Skill folder.
+
+## Install
+
+```sh
+npm install --global @agent-proxy-kit/puraroute-mcp-server
+puraroute-proxy-mcp --setup
+```
+
+The setup output prints the installed MCP launcher, the bundled Skill folder, the Codex and Claude Code user Skill destinations, and MCP registration examples. The package includes the full [setup guide](bundle/skill/puraroute-proxy/references/setup.md).
+
+## Ask your local Agent
+
+Give an Agent with permission to operate your machine this task:
+
+> Install @agent-proxy-kit/puraroute-mcp-server if needed and run `puraroute-proxy-mcp --setup`. Read its output and the bundled setup guide. Ask which Agent client I use. Copy the entire bundled Skill folder to that client's user Skill directory, checking before replacing an existing folder. Register the printed local stdio MCP launcher. Help me supply the approved HTTPS API origin and account API key through a trusted local secret source inherited by the client; do not ask me to paste the key into chat or put it in command arguments, project files, or Skill text. Restart or refresh the client, verify the Skill is available and the MCP service is `puraroute-proxy-mcp`, then compare its tools with the bundled manifest. Do not call purchase, renewal, or account-write tools merely to test setup. If you cannot access my machine, give me the exact manual steps instead.
+
+Codex loads user Skills from `~/.agents/skills/puraroute-proxy`; Claude Code loads them from `~/.claude/skills/puraroute-proxy`. On Windows, use the equivalent folders under your home directory. The MCP process needs `PROXY_AGENT_API_ORIGIN` (approved HTTPS origin without a path) and `PROXY_AGENT_API_KEY` for the same instance. For help, see https://puraroute.com.

package/bundle/adapter-policy.json

@@ -0,0 +1,11 @@
+{
+  "envelope": {
+    "code": "code",
+    "message": "msg",
+    "data": "data",
+    "next": "next"
+  },
+  "successCodes": [0],
+  "successHttpStatuses": [200],
+  "requiredResponseFields": ["code", "msg", "data", "next"]
+}

package/bundle/brand.json

@@ -0,0 +1,9 @@
+{
+  "id": "self",
+  "npmPackageName": "@agent-proxy-kit/puraroute-mcp-server",
+  "displayName": "PuraRoute",
+  "serverName": "puraroute-proxy-mcp",
+  "skillName": "puraroute-proxy",
+  "supportUrl": "https://puraroute.com",
+  "version": "0.1.1"
+}

package/bundle/bundle-manifest.json

@@ -0,0 +1,34 @@
+{
+  "bundleVersion": "0.1.1",
+  "runtimeVersion": "0.1.0",
+  "contractSha256": "bc4e1311eece2abf89405de88d1adc8fb4e7ff937ee2c83ae31d87b736a49af7",
+  "toolSchemasSha256": "95ed1ca230f4197d012c356f366711510aaf2f7c132adbb9e6afe685a505fa6c",
+  "operations": [
+    "createDynamicAccount",
+    "createStaticPurchaseOrder",
+    "createStaticRenewalOrder",
+    "generateDynamicProxyCredentials",
+    "getDynamicAccount",
+    "getDynamicTrafficBalance",
+    "getDynamicTrafficOrder",
+    "getStaticInventory",
+    "getStaticPurchaseOrder",
+    "getStaticRenewalOrder",
+    "getWalletBalance",
+    "listDynamicAccounts",
+    "listDynamicDailyUsage",
+    "listDynamicRegions",
+    "listDynamicTrafficOrders",
+    "listDynamicTrafficProducts",
+    "listEffectiveDynamicTrafficLots",
+    "listStaticPurchaseOrders",
+    "listStaticRegions",
+    "listStaticRenewalOrders",
+    "listStaticResources",
+    "purchaseDynamicTraffic",
+    "quoteStaticPurchase",
+    "quoteStaticRenewal",
+    "setDynamicAccountStatus",
+    "updateDynamicAccountLimit"
+  ]
+}