auxilo-mcp 0.2.0 → 0.7.0

package/README.md

@@ -2,7 +2,7 @@
 
 Agent capability discovery and knowledge marketplace. Find the right tool for any task. Learn from what other agents already figured out.
 
-**Live API**: `https://3000-725fa3fea775ba39db5a2e3703fa4557.life.conway.tech`
+**Live API**: `https://api.auxilo.io`
 
 ## What it does
 
@@ -18,13 +18,13 @@ Auxilo solves two problems for AI agents:
 
 ```bash
 # Free — check what's available
-curl https://3000-725fa3fea775ba39db5a2e3703fa4557.life.conway.tech/categories
+curl https://api.auxilo.io/categories
 
 # Free — marketplace stats
-curl https://3000-725fa3fea775ba39db5a2e3703fa4557.life.conway.tech/knowledge/stats
+curl https://api.auxilo.io/knowledge/stats
 
 # Free — submit a learning
-curl -X POST https://3000-725fa3fea775ba39db5a2e3703fa4557.life.conway.tech/learn \
+curl -X POST https://api.auxilo.io/learn \
   -H "Content-Type: application/json" \
   -d '{
     "title": "E2B sessions timeout after 5 min idle",
@@ -60,7 +60,9 @@ Add to your Claude Desktop config (`claude_desktop_config.json`):
 
 Then ask Claude: *"Search Auxilo for an email API"* or *"Find knowledge about Firecrawl rate limits"*
 
-**MCP Tools:**
+**MCP Tools (v0.7.0):**
+
+*Auxilo Core*
 - `auxilo_discover` — Search the skills registry
 - `auxilo_skill` — Get full details for a specific skill
 - `auxilo_categories` — List all categories
@@ -70,6 +72,23 @@ Then ask Claude: *"Search Auxilo for an email API"* or *"Find knowledge about Fi
 - `auxilo_unlock` — Read full learning content
 - `auxilo_rate` — Rate a learning after using it
 - `auxilo_contributor` — Check contributor earnings
+- `auxilo_verify_wallet` — Wallet ownership verification flow
+- `auxilo_withdraw` — Request withdrawal of earned USDC
+- `auxilo_settlements` — Check settlement history for a wallet
+- `auxilo_link_wallet` — Link a verified wallet to your account
+- `auxilo_account_earnings` — View earnings for your authenticated account
+
+*Renderly (v0.7.0 — new)*
+- `renderly_markdown` — Convert any public URL to clean markdown ($0.001)
+- `renderly_extract` — Extract structured data from any URL ($0.001)
+- `renderly_readable` — Get plain readable text from any URL ($0.0005)
+- `renderly_llms_txt` — Get the LLM-readable Renderly service description (free)
+- `renderly_health` — Check Renderly service health (free)
+- `renderly_pricing` — Get Renderly pricing info (free)
+
+*Stats (v0.7.0 — new)*
+- `get_stats` — Registry statistics (alias, free)
+- `get_knowledge_stats` — Knowledge marketplace statistics (free)
 
 ## Skill categories
 
@@ -134,6 +153,22 @@ GET /.well-known/agent.json
 | GET | `/knowledge/:id` | Dynamic (min $0.005) | Unlock full learning (price set by contributor) |
 | POST | `/knowledge/:id/rate` | Free | Rate a learning |
 | GET | `/contributor/:wallet` | Free | Contributor earnings |
+| POST | `/auth/magic-link` | Free | Request magic link login |
+| GET | `/auth/verify` | Free | Verify magic link token, returns JWT |
+| GET | `/account/dashboard` | Free | Account overview (requires JWT) |
+| POST | `/account/api-keys` | Free | Create API key (requires JWT) |
+| GET | `/account/earnings` | Free | Earnings with pending balance (requires JWT) |
+| POST | `/admin/stage-key` | Free | Stage new wallet key for rotation (admin) |
+
+## Production infrastructure
+
+The live API runs on Conway Cloud with PM2 process management:
+
+- **Health monitoring** — `/health` returns uptime, catalog size, and timestamp
+- **Graceful shutdown** — In-flight requests complete before exit; new requests get 503
+- **Auto-restart** — PM2 restarts the process on crash with exponential backoff
+- **Rate limiting** — Persistent across restarts (state saved to disk)
+- **Key rotation** — Zero-downtime wallet key staging via `/admin/stage-key`
 
 ## Running locally
 

package/mcp-server.js

@@ -10,7 +10,7 @@ const {
 const AUXILO_BASE = 'https://3000-725fa3fea775ba39db5a2e3703fa4557.life.conway.tech';
 
 const server = new Server(
-  { name: 'auxilo', version: '0.2.0' },
+  { name: 'auxilo', version: '0.7.0' },
   { capabilities: { tools: {} } }
 );
 
@@ -126,6 +126,42 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         required: ['id', 'helpfulness'],
       },
     },
+    {
+      name: 'auxilo_verify_wallet',
+      description: 'Wallet ownership verification flow. If signature is omitted, returns a challenge string. Sign the challenge with your wallet and call again with signature to complete verification.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          wallet: { type: 'string', description: 'Wallet address (0x...)' },
+          signature: { type: 'string', description: 'Optional: cryptographic signature of the challenge' }
+        },
+        required: ['wallet']
+      }
+    },
+    {
+      name: 'auxilo_withdraw',
+      description: 'Request withdrawal of earned USDC. Requires a valid cryptographic signature of: "auxilo-withdraw-{wallet}-{amount}-{timestamp}".',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          wallet: { type: 'string', description: 'Verified contributor wallet address (0x...)' },
+          signature: { type: 'string', description: 'Signature of the withdrawal payload' },
+          timestamp: { type: 'number', description: 'Unix timestamp in milliseconds (must be within 5 mins of server time)' }
+        },
+        required: ['wallet', 'signature', 'timestamp']
+      }
+    },
+    {
+      name: 'auxilo_settlements',
+      description: 'Check settlement history and processing status for withdrawals on a given wallet. Free.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          wallet: { type: 'string', description: 'Contributor wallet address (0x...)' },
+        },
+        required: ['wallet']
+      }
+    },
     {
       name: 'auxilo_contributor',
       description: 'Check earnings for a contributor wallet. Shows total earned, per-learning breakdown. Free.',
@@ -137,6 +173,90 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         required: ['wallet'],
       },
     },
+    {
+      name: 'auxilo_link_wallet',
+      description: 'Link a verified wallet address to your Auxilo account. Requires session JWT (from magic link login) and the wallet must have been previously verified via auxilo_verify_wallet. One wallet per account. Required to withdraw earnings.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          wallet: { type: 'string', description: 'Verified wallet address (0x...) to link to your account' },
+          session_token: { type: 'string', description: 'JWT session token from /auth/verify (Bearer token)' },
+        },
+        required: ['wallet', 'session_token'],
+      },
+    },
+    {
+      name: 'auxilo_account_earnings',
+      description: 'View earnings for your authenticated Auxilo account. Requires session JWT. Returns total gross, contributor share, pending balance, total withdrawn, and whether withdrawal is available (can_withdraw). Free.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          session_token: { type: 'string', description: 'JWT session token from /auth/verify (Bearer token)' },
+        },
+        required: ['session_token'],
+      },
+    },
+    {
+      name: 'renderly_markdown',
+      description: 'Convert any public URL to clean markdown. Strips navigation, ads, and boilerplate — returns only the meaningful content. Costs $0.001 USDC via x402 or API key.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          url: { type: 'string', description: 'Public URL to convert to markdown' },
+          x_payment: { type: 'string', description: 'x402 payment header' },
+        },
+        required: ['url'],
+      },
+    },
+    {
+      name: 'renderly_extract',
+      description: 'Extract structured data from any public URL — title, description, headings, links, images, and meta tags. Costs $0.001 USDC via x402 or API key.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          url: { type: 'string', description: 'Public URL to extract structured data from' },
+          x_payment: { type: 'string', description: 'x402 payment header' },
+        },
+        required: ['url'],
+      },
+    },
+    {
+      name: 'renderly_readable',
+      description: 'Get plain readable text from any public URL — no markdown formatting, no HTML, just the content. Costs $0.0005 USDC via x402 or API key.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          url: { type: 'string', description: 'Public URL to extract readable text from' },
+          x_payment: { type: 'string', description: 'x402 payment header' },
+        },
+        required: ['url'],
+      },
+    },
+    {
+      name: 'renderly_llms_txt',
+      description: 'Get the LLM-readable service description for Renderly — what it does, endpoints, and usage. Free.',
+      inputSchema: { type: 'object', properties: {} },
+    },
+    {
+      name: 'renderly_health',
+      description: 'Check Renderly service health status. Free.',
+      inputSchema: { type: 'object', properties: {} },
+    },
+    {
+      name: 'renderly_pricing',
+      description: 'Get Renderly pricing information for all endpoints. Free.',
+      inputSchema: { type: 'object', properties: {} },
+    },
+    {
+      name: 'get_stats',
+      description: 'Get Auxilo registry statistics — catalog size, skill types, and query volume. Free.',
+      inputSchema: { type: 'object', properties: {} },
+    },
+    {
+      name: 'get_knowledge_stats',
+      description: 'Get knowledge marketplace statistics — total learnings, unlocks, contributors, and top categories. Free.',
+      inputSchema: { type: 'object', properties: {} },
+    },
   ],
 }));
 
@@ -263,11 +383,144 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return text(await resp.json());
       }
 
+      case 'auxilo_verify_wallet': {
+        const url = args.signature ? `${AUXILO_BASE}/wallet/verify` : `${AUXILO_BASE}/wallet/challenge`;
+        const resp = await fetch(url, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(args)
+        });
+        return text(await resp.json());
+      }
+
+      case 'auxilo_withdraw': {
+        const resp = await fetch(`${AUXILO_BASE}/withdraw`, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(args)
+        });
+        return text(await resp.json());
+      }
+
+      case 'auxilo_settlements': {
+        const resp = await fetch(`${AUXILO_BASE}/contributor/${args.wallet}/settlements`);
+        return text(await resp.json());
+      }
+
       case 'auxilo_contributor': {
         const resp = await fetch(`${AUXILO_BASE}/contributor/${args.wallet}`);
         return text(await resp.json());
       }
 
+      case 'auxilo_link_wallet': {
+        const resp = await fetch(`${AUXILO_BASE}/account/link-wallet`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${args.session_token}`,
+          },
+          body: JSON.stringify({ wallet: args.wallet }),
+        });
+        return text(await resp.json());
+      }
+
+      case 'auxilo_account_earnings': {
+        const resp = await fetch(`${AUXILO_BASE}/account/earnings`, {
+          headers: {
+            'Authorization': `Bearer ${args.session_token}`,
+          },
+        });
+        return text(await resp.json());
+      }
+
+      case 'renderly_markdown': {
+        const headers = { 'Content-Type': 'application/json' };
+        if (args.x_payment) headers['X-Payment'] = args.x_payment;
+
+        const resp = await fetch(`${AUXILO_BASE}/renderly/markdown`, {
+          method: 'POST',
+          headers,
+          body: JSON.stringify({ url: args.url }),
+        });
+        const data = await resp.json();
+        if (resp.status === 402) {
+          return text({
+            status: 'payment_required',
+            cost: '$0.001 USDC on Base',
+            http_endpoint: `${AUXILO_BASE}/renderly/markdown`,
+            payment_details: data,
+          });
+        }
+        return text(data);
+      }
+
+      case 'renderly_extract': {
+        const headers = { 'Content-Type': 'application/json' };
+        if (args.x_payment) headers['X-Payment'] = args.x_payment;
+
+        const resp = await fetch(`${AUXILO_BASE}/renderly/extract`, {
+          method: 'POST',
+          headers,
+          body: JSON.stringify({ url: args.url }),
+        });
+        const data = await resp.json();
+        if (resp.status === 402) {
+          return text({
+            status: 'payment_required',
+            cost: '$0.001 USDC on Base',
+            http_endpoint: `${AUXILO_BASE}/renderly/extract`,
+            payment_details: data,
+          });
+        }
+        return text(data);
+      }
+
+      case 'renderly_readable': {
+        const headers = { 'Content-Type': 'application/json' };
+        if (args.x_payment) headers['X-Payment'] = args.x_payment;
+
+        const resp = await fetch(`${AUXILO_BASE}/renderly/readable`, {
+          method: 'POST',
+          headers,
+          body: JSON.stringify({ url: args.url }),
+        });
+        const data = await resp.json();
+        if (resp.status === 402) {
+          return text({
+            status: 'payment_required',
+            cost: '$0.0005 USDC on Base',
+            http_endpoint: `${AUXILO_BASE}/renderly/readable`,
+            payment_details: data,
+          });
+        }
+        return text(data);
+      }
+
+      case 'renderly_llms_txt': {
+        const resp = await fetch(`${AUXILO_BASE}/renderly/llms.txt`);
+        return text(await resp.json());
+      }
+
+      case 'renderly_health': {
+        const resp = await fetch(`${AUXILO_BASE}/renderly/health`);
+        return text(await resp.json());
+      }
+
+      case 'renderly_pricing': {
+        const resp = await fetch(`${AUXILO_BASE}/renderly/pricing`);
+        return text(await resp.json());
+      }
+
+      case 'get_stats': {
+        const resp = await fetch(`${AUXILO_BASE}/stats`);
+        return text(await resp.json());
+      }
+
+      case 'get_knowledge_stats': {
+        const resp = await fetch(`${AUXILO_BASE}/knowledge/stats`);
+        return text(await resp.json());
+      }
+
       default:
         return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auxilo-mcp",
-  "version": "0.2.0",
+  "version": "0.7.0",
   "description": "MCP server for Auxilo — Agent Capability Discovery & Knowledge Marketplace",
   "main": "mcp-server.js",
   "bin": {
@@ -30,6 +30,11 @@
   "homepage": "https://auxilo.io",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0"
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "stripe": "^17.0.0",
+    "viem": "^2.46.3"
+  },
+  "devDependencies": {
+    "proxyquire": "^2.1.3"
   }
 }