create-settlegrid-tool 1.0.0

package/dist/index.js

@@ -0,0 +1,295 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import prompts from "prompts";
+import pc3 from "picocolors";
+import path2 from "path";
+
+// src/scaffold.ts
+import fs from "fs-extra";
+import path from "path";
+import pc from "picocolors";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path.dirname(__filename);
+function getTemplatesDir() {
+  const candidates = [
+    path.resolve(__dirname, "..", "templates"),
+    path.resolve(__dirname, "..", "..", "templates")
+  ];
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  return candidates[0];
+}
+function replacePlaceholders(content, config) {
+  return content.replace(/\{\{TOOL_NAME\}\}/g, config.toolName).replace(/\{\{TOOL_SLUG\}\}/g, config.toolSlug).replace(/\{\{DESCRIPTION\}\}/g, config.description).replace(/\{\{PRICE_CENTS\}\}/g, String(config.priceCents)).replace(/\{\{CATEGORY\}\}/g, config.category).replace(/\{\{PRICING_MODEL\}\}/g, config.pricingModel);
+}
+async function copyTemplateDir(templateDir, targetDir, config) {
+  const entries = await fs.readdir(templateDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(templateDir, entry.name);
+    const targetName = entry.name.startsWith("_dot_") ? "." + entry.name.slice(5) : entry.name;
+    const destPath = path.join(targetDir, targetName);
+    if (entry.isDirectory()) {
+      await fs.ensureDir(destPath);
+      await copyTemplateDir(srcPath, destPath, config);
+    } else {
+      const content = await fs.readFile(srcPath, "utf-8");
+      const processed = replacePlaceholders(content, config);
+      await fs.writeFile(destPath, processed, "utf-8");
+      console.log(`  ${pc.green("+")} ${path.relative(config.targetDir, destPath)}`);
+    }
+  }
+}
+async function scaffold(config) {
+  const templatesDir = getTemplatesDir();
+  if (await fs.pathExists(config.targetDir)) {
+    const files = await fs.readdir(config.targetDir);
+    if (files.length > 0) {
+      throw new Error(
+        `Directory "${config.directory}" already exists and is not empty.`
+      );
+    }
+  }
+  await fs.ensureDir(config.targetDir);
+  const templatePath = path.join(templatesDir, config.template);
+  if (!await fs.pathExists(templatePath)) {
+    throw new Error(`Template "${config.template}" not found at ${templatePath}`);
+  }
+  await copyTemplateDir(templatePath, config.targetDir, config);
+  if (config.deployTarget === "vercel") {
+    const vercelConfig = JSON.stringify(
+      {
+        buildCommand: "npm run build",
+        outputDirectory: "dist"
+      },
+      null,
+      2
+    );
+    await fs.writeFile(
+      path.join(config.targetDir, "vercel.json"),
+      vercelConfig + "\n",
+      "utf-8"
+    );
+    console.log(`  ${pc.green("+")} vercel.json`);
+  }
+  if (config.deployTarget === "docker") {
+    const dockerfile = `FROM node:20-slim AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM node:20-slim
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package.json ./
+EXPOSE 3000
+CMD ["node", "dist/server.js"]
+`;
+    await fs.writeFile(
+      path.join(config.targetDir, "Dockerfile"),
+      dockerfile,
+      "utf-8"
+    );
+    console.log(`  ${pc.green("+")} Dockerfile`);
+    const dockerignore = `node_modules
+dist
+.env
+.git
+`;
+    await fs.writeFile(
+      path.join(config.targetDir, ".dockerignore"),
+      dockerignore,
+      "utf-8"
+    );
+    console.log(`  ${pc.green("+")} .dockerignore`);
+  }
+  if (config.deployTarget === "railway") {
+    const railwayToml = `[build]
+builder = "nixpacks"
+
+[deploy]
+startCommand = "npm start"
+`;
+    await fs.writeFile(
+      path.join(config.targetDir, "railway.toml"),
+      railwayToml,
+      "utf-8"
+    );
+    console.log(`  ${pc.green("+")} railway.toml`);
+  }
+}
+
+// src/banner.ts
+import pc2 from "picocolors";
+function banner() {
+  const emerald = pc2.green;
+  const dim = pc2.dim;
+  const art = `
+${emerald("   ___      _   _   _       ___      _    _ ")}
+${emerald("  / __| ___| |_| |_| |___  / __|_ __(_)__| |")}
+${emerald("  \\__ \\/ -_)  _|  _| / -_)| (_ | '_| / _` |")}
+${emerald("  |___/\\___|\\__|\\__|_\\___| \\___|_| |_\\__,_|")}
+`;
+  const tagline = dim("  The Settlement Layer for the AI Economy");
+  const version = dim("  v1.0.0");
+  const separator = dim("  " + "-".repeat(44));
+  return `${art}${tagline}
+${version}
+${separator}
+`;
+}
+
+// src/index.ts
+var CATEGORIES = [
+  { title: "Data", value: "data" },
+  { title: "NLP", value: "nlp" },
+  { title: "Search", value: "search" },
+  { title: "Finance", value: "finance" },
+  { title: "Code", value: "code" },
+  { title: "Security", value: "security" },
+  { title: "Analytics", value: "analytics" },
+  { title: "Other", value: "other" }
+];
+var PRICING_MODELS = [
+  { title: "Per call", value: "per-call" },
+  { title: "Per token", value: "per-token" },
+  { title: "Per byte", value: "per-byte" }
+];
+var TEMPLATES = [
+  { title: "Blank \u2014 minimal settlegrid.init() + sg.wrap()", value: "blank" },
+  { title: "REST API \u2014 Express.js server with billing middleware", value: "rest-api" },
+  { title: "OpenAPI \u2014 scaffold from an OpenAPI spec", value: "openapi" },
+  { title: "MCP Server \u2014 full MCP server with stdio transport", value: "mcp-server" }
+];
+var DEPLOY_TARGETS = [
+  { title: "Vercel", value: "vercel" },
+  { title: "Railway", value: "railway" },
+  { title: "Docker", value: "docker" },
+  { title: "None", value: "none" }
+];
+function toSlug(name) {
+  return name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+async function main() {
+  console.log(banner());
+  const dirArg = process.argv[2];
+  if (dirArg === "--help" || dirArg === "-h") {
+    console.log(`
+  ${pc3.bold("Usage:")} npx create-settlegrid-tool ${pc3.cyan("[directory]")}
+
+  ${pc3.dim("Creates a monetized AI tool project with SettleGrid billing.")}
+
+  ${pc3.bold("Options:")}
+    ${pc3.cyan("[directory]")}   Project directory name (default: prompted)
+    ${pc3.cyan("--help, -h")}   Show this help message
+    ${pc3.cyan("--version")}    Show version
+`);
+    process.exit(0);
+  }
+  if (dirArg === "--version") {
+    console.log("1.0.0");
+    process.exit(0);
+  }
+  let cancelled = false;
+  const response = await prompts(
+    [
+      {
+        type: dirArg ? null : "text",
+        name: "directory",
+        message: "Project directory",
+        initial: "my-tool",
+        validate: (v) => v.length > 0 ? true : "Directory name is required"
+      },
+      {
+        type: "text",
+        name: "toolName",
+        message: "Tool name",
+        initial: (prev) => prev || dirArg || "my-tool"
+      },
+      {
+        type: "text",
+        name: "description",
+        message: "Description",
+        initial: "A monetized AI tool powered by SettleGrid"
+      },
+      {
+        type: "select",
+        name: "category",
+        message: "Category",
+        choices: [...CATEGORIES]
+      },
+      {
+        type: "select",
+        name: "pricingModel",
+        message: "Pricing model",
+        choices: [...PRICING_MODELS]
+      },
+      {
+        type: "number",
+        name: "priceCents",
+        message: "Default price per call (cents)",
+        initial: 2,
+        min: 0
+      },
+      {
+        type: "select",
+        name: "template",
+        message: "Template",
+        choices: [...TEMPLATES]
+      },
+      {
+        type: "select",
+        name: "deployTarget",
+        message: "Deploy target",
+        choices: [...DEPLOY_TARGETS]
+      }
+    ],
+    {
+      onCancel: () => {
+        cancelled = true;
+      }
+    }
+  );
+  if (cancelled) {
+    console.log(pc3.red("\nSetup cancelled."));
+    process.exit(1);
+  }
+  const directory = dirArg || response.directory;
+  const toolSlug = toSlug(directory);
+  const targetDir = path2.resolve(process.cwd(), directory);
+  const config = {
+    directory,
+    toolName: response.toolName || directory,
+    toolSlug,
+    description: response.description || "A monetized AI tool powered by SettleGrid",
+    category: response.category || "other",
+    pricingModel: response.pricingModel || "per-call",
+    priceCents: response.priceCents ?? 2,
+    template: response.template || "blank",
+    deployTarget: response.deployTarget || "none",
+    targetDir
+  };
+  console.log();
+  console.log(pc3.dim("  Scaffolding project..."));
+  console.log();
+  await scaffold(config);
+  console.log(pc3.green(pc3.bold("  Done!")) + " Your tool is ready.\n");
+  console.log(`  ${pc3.dim("$")} ${pc3.cyan(`cd ${directory}`)}`);
+  console.log(`  ${pc3.dim("$")} ${pc3.cyan("npm install")}`);
+  console.log(`  ${pc3.dim("$")} ${pc3.cyan("npm run dev")}
+`);
+  console.log(
+    pc3.dim("  Next: Register your tool at ") + pc3.cyan(pc3.underline("https://settlegrid.ai/dashboard/tools")) + "\n"
+  );
+}
+main().catch((err) => {
+  console.error(pc3.red("Error:"), err instanceof Error ? err.message : err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "create-settlegrid-tool",
+  "version": "1.0.0",
+  "description": "Create a monetized AI tool with SettleGrid in 30 seconds",
+  "keywords": [
+    "settlegrid",
+    "mcp",
+    "ai",
+    "monetization",
+    "cli",
+    "scaffold",
+    "create",
+    "tool",
+    "ai-economy",
+    "billing"
+  ],
+  "homepage": "https://settlegrid.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lexwhiting/settlegrid.git",
+    "directory": "packages/create-settlegrid-tool"
+  },
+  "bugs": {
+    "url": "https://github.com/lexwhiting/settlegrid/issues",
+    "email": "support@settlegrid.ai"
+  },
+  "author": {
+    "name": "Alerterra, LLC",
+    "email": "support@settlegrid.ai",
+    "url": "https://settlegrid.ai"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "create-settlegrid-tool": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "fs-extra": "^11.2.0",
+    "picocolors": "^1.1.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.0.0",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  }
+}

package/templates/blank/README.md

@@ -0,0 +1,35 @@
+# {{TOOL_NAME}}
+
+{{DESCRIPTION}}
+
+## Quick Start
+
+```bash
+npm install
+npm run dev
+```
+
+## Pricing
+
+| Method | Cost |
+| --- | --- |
+| `query` | {{PRICE_CENTS}} cents per call |
+
+Billing is handled automatically by [SettleGrid](https://settlegrid.ai). Users purchase credits and are billed per call.
+
+## Development
+
+```bash
+npm run dev      # Start with hot reload
+npm run build    # Compile TypeScript
+npm start        # Run compiled output
+```
+
+## Deploy
+
+Register your tool at [settlegrid.ai/dashboard/tools](https://settlegrid.ai/dashboard/tools) to start accepting payments.
+
+## Documentation
+
+- [SettleGrid Docs](https://settlegrid.ai/docs)
+- [@settlegrid/mcp SDK](https://www.npmjs.com/package/@settlegrid/mcp)

package/templates/blank/_dot_env.example

@@ -0,0 +1,3 @@
+SETTLEGRID_TOOL_SLUG={{TOOL_SLUG}}
+# Add your API keys here:
+# API_KEY=your-key-here

package/templates/blank/_dot_gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+.env
+*.tsbuildinfo

package/templates/blank/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "{{TOOL_SLUG}}",
+  "version": "1.0.0",
+  "description": "{{DESCRIPTION}}",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/server.ts",
+    "build": "tsc",
+    "start": "node dist/server.js"
+  },
+  "dependencies": {
+    "@settlegrid/mcp": "^0.1.1"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/templates/blank/src/server.ts

@@ -0,0 +1,24 @@
+import { settlegrid } from '@settlegrid/mcp'
+
+const sg = settlegrid.init({
+  toolSlug: '{{TOOL_SLUG}}', // Replace with your registered slug from settlegrid.ai
+  pricing: {
+    defaultCostCents: {{PRICE_CENTS}},
+    methods: {
+      'query': { costCents: {{PRICE_CENTS}}, displayName: 'Query' },
+    },
+  },
+})
+
+// Your tool handler — replace with your actual logic
+async function handleQuery(args: { query: string }) {
+  // TODO: Implement your tool logic here
+  return { result: `Response for: ${args.query}` }
+}
+
+// Wrap with SettleGrid billing
+export const query = sg.wrap(handleQuery, { method: 'query' })
+
+// Example usage:
+// const result = await query({ query: 'hello world' })
+// console.log(result)

package/templates/blank/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/mcp-server/README.md

@@ -0,0 +1,55 @@
+# {{TOOL_NAME}}
+
+{{DESCRIPTION}}
+
+A full MCP (Model Context Protocol) server with SettleGrid billing.
+
+## Quick Start
+
+```bash
+npm install
+npm run dev
+```
+
+## MCP Configuration
+
+Add to your MCP client configuration (e.g., Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "{{TOOL_SLUG}}": {
+      "command": "node",
+      "args": ["dist/server.js"]
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description | Cost |
+| --- | --- | --- |
+| `query` | Run a query | {{PRICE_CENTS}} cents per call |
+
+## Pricing
+
+Billing is handled automatically by [SettleGrid](https://settlegrid.ai). Users purchase credits and are billed per call.
+
+## Development
+
+```bash
+npm run dev      # Start with hot reload
+npm run build    # Compile TypeScript
+npm start        # Run compiled output
+```
+
+## Deploy
+
+Register your tool at [settlegrid.ai/dashboard/tools](https://settlegrid.ai/dashboard/tools) to start accepting payments.
+
+## Documentation
+
+- [MCP Specification](https://modelcontextprotocol.io)
+- [SettleGrid Docs](https://settlegrid.ai/docs)
+- [@settlegrid/mcp SDK](https://www.npmjs.com/package/@settlegrid/mcp)

package/templates/mcp-server/_dot_env.example

@@ -0,0 +1,3 @@
+SETTLEGRID_TOOL_SLUG={{TOOL_SLUG}}
+# Add your API keys here:
+# API_KEY=your-key-here

package/templates/mcp-server/_dot_gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+.env
+*.tsbuildinfo

package/templates/mcp-server/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "{{TOOL_SLUG}}",
+  "version": "1.0.0",
+  "description": "{{DESCRIPTION}}",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/server.ts",
+    "build": "tsc",
+    "start": "node dist/server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@settlegrid/mcp": "^0.1.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/templates/mcp-server/src/server.ts

@@ -0,0 +1,61 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { z } from 'zod'
+import { settlegrid } from '@settlegrid/mcp'
+
+// Initialize SettleGrid billing
+const sg = settlegrid.init({
+  toolSlug: '{{TOOL_SLUG}}', // Replace with your registered slug from settlegrid.ai
+  pricing: {
+    defaultCostCents: {{PRICE_CENTS}},
+    methods: {
+      'query': { costCents: {{PRICE_CENTS}}, displayName: 'Query' },
+    },
+  },
+})
+
+// Wrap your tool handler with SettleGrid billing
+const query = sg.wrap(
+  async (args: { query: string }) => {
+    // TODO: Implement your tool logic here
+    return { result: `Response for: ${args.query}` }
+  },
+  { method: 'query' }
+)
+
+// Create the MCP server
+const server = new McpServer({
+  name: '{{TOOL_SLUG}}',
+  version: '1.0.0',
+})
+
+// Register tools
+server.tool(
+  'query',
+  'Run a query against {{TOOL_NAME}}',
+  {
+    query: z.string().describe('The query to run'),
+  },
+  async ({ query: queryText }) => {
+    const result = await query({ query: queryText })
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify(result, null, 2),
+        },
+      ],
+    }
+  }
+)
+
+// Start the server with stdio transport
+async function main() {
+  const transport = new StdioServerTransport()
+  await server.connect(transport)
+}
+
+main().catch((error) => {
+  console.error('Server error:', error)
+  process.exit(1)
+})

package/templates/mcp-server/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/openapi/README.md

@@ -0,0 +1,53 @@
+# {{TOOL_NAME}}
+
+{{DESCRIPTION}}
+
+Built from an OpenAPI spec with [SettleGrid](https://settlegrid.ai) billing.
+
+## Quick Start
+
+```bash
+npm install
+npm run dev
+```
+
+The server starts at `http://localhost:3000`.
+
+## Adding Endpoints
+
+Add endpoints from your OpenAPI spec in `src/server.ts`. Each endpoint is wrapped with SettleGrid billing:
+
+```typescript
+const myEndpoint = sg.wrap(
+  async (args: { id: string }) => {
+    const response = await fetch(`${UPSTREAM_URL}/resource/${args.id}`)
+    return response.json()
+  },
+  { method: 'get-resource' }
+)
+```
+
+## Pricing
+
+| Method | Cost |
+| --- | --- |
+| Default | {{PRICE_CENTS}} cents per call |
+
+Billing is handled automatically by [SettleGrid](https://settlegrid.ai).
+
+## Development
+
+```bash
+npm run dev      # Start with hot reload
+npm run build    # Compile TypeScript
+npm start        # Run compiled output
+```
+
+## Deploy
+
+Register your tool at [settlegrid.ai/dashboard/tools](https://settlegrid.ai/dashboard/tools) to start accepting payments.
+
+## Documentation
+
+- [SettleGrid Docs](https://settlegrid.ai/docs)
+- [@settlegrid/mcp SDK](https://www.npmjs.com/package/@settlegrid/mcp)

package/templates/openapi/_dot_env.example

@@ -0,0 +1,5 @@
+SETTLEGRID_TOOL_SLUG={{TOOL_SLUG}}
+PORT=3000
+# Your upstream API base URL:
+# UPSTREAM_API_URL=https://api.example.com
+# UPSTREAM_API_KEY=your-key-here

package/templates/openapi/_dot_gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+.env
+*.tsbuildinfo

package/templates/openapi/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "{{TOOL_SLUG}}",
+  "version": "1.0.0",
+  "description": "{{DESCRIPTION}}",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/server.ts",
+    "build": "tsc",
+    "start": "node dist/server.js"
+  },
+  "dependencies": {
+    "@settlegrid/mcp": "^0.1.1",
+    "express": "^4.21.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/templates/openapi/src/server.ts

@@ -0,0 +1,79 @@
+import express from 'express'
+import { settlegrid } from '@settlegrid/mcp'
+
+const app = express()
+app.use(express.json())
+
+const UPSTREAM_URL = process.env.UPSTREAM_API_URL || 'https://api.example.com'
+
+const sg = settlegrid.init({
+  toolSlug: '{{TOOL_SLUG}}', // Replace with your registered slug from settlegrid.ai
+  pricing: {
+    defaultCostCents: {{PRICE_CENTS}},
+    methods: {
+      // Add a method entry for each OpenAPI endpoint you want to monetize:
+      // 'get-resource': { costCents: {{PRICE_CENTS}}, displayName: 'Get Resource' },
+      // 'search': { costCents: {{PRICE_CENTS}}, displayName: 'Search' },
+      // 'create-resource': { costCents: 5, displayName: 'Create Resource' },
+    },
+  },
+})
+
+// ------------------------------------------------------------------
+// Add your OpenAPI endpoints below.
+//
+// For each endpoint in your OpenAPI spec, create a wrapped handler:
+//
+//   const getResource = sg.wrap(
+//     async (args: { id: string }) => {
+//       const res = await fetch(`${UPSTREAM_URL}/resources/${args.id}`, {
+//         headers: { 'Authorization': `Bearer ${process.env.UPSTREAM_API_KEY}` },
+//       })
+//       if (!res.ok) throw new Error(`Upstream error: ${res.status}`)
+//       return res.json()
+//     },
+//     { method: 'get-resource' }
+//   )
+//
+//   app.get('/resources/:id', async (req, res) => {
+//     try {
+//       const result = await getResource({ id: req.params.id })
+//       res.json(result)
+//     } catch (error) {
+//       const message = error instanceof Error ? error.message : 'Internal server error'
+//       res.status(500).json({ error: message })
+//     }
+//   })
+// ------------------------------------------------------------------
+
+// Example endpoint — replace with your actual OpenAPI operations
+const query = sg.wrap(
+  async (args: { query: string }) => {
+    // TODO: Forward to your upstream API
+    // const res = await fetch(`${UPSTREAM_URL}/search?q=${encodeURIComponent(args.query)}`)
+    // return res.json()
+    return { result: `Response for: ${args.query}`, upstream: UPSTREAM_URL }
+  },
+  { method: 'query' }
+)
+
+app.post('/query', async (req, res) => {
+  try {
+    const result = await query(req.body)
+    res.json(result)
+  } catch (error) {
+    const message = error instanceof Error ? error.message : 'Internal server error'
+    res.status(500).json({ error: message })
+  }
+})
+
+// Health check (no billing)
+app.get('/health', (_req, res) => {
+  res.json({ status: 'ok', tool: '{{TOOL_SLUG}}', timestamp: new Date().toISOString() })
+})
+
+const PORT = process.env.PORT || 3000
+app.listen(PORT, () => {
+  console.log(`{{TOOL_NAME}} running at http://localhost:${PORT}`)
+  console.log(`Health check: http://localhost:${PORT}/health`)
+})

package/templates/openapi/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/rest-api/README.md

@@ -0,0 +1,40 @@
+# {{TOOL_NAME}}
+
+{{DESCRIPTION}}
+
+## Quick Start
+
+```bash
+npm install
+npm run dev
+```
+
+The server starts at `http://localhost:3000`.
+
+## Endpoints
+
+| Endpoint | Method | Cost |
+| --- | --- | --- |
+| `POST /query` | query | {{PRICE_CENTS}} cents per call |
+| `GET /health` | - | Free |
+
+## Pricing
+
+Billing is handled automatically by [SettleGrid](https://settlegrid.ai). Users purchase credits and are billed per call via the `x-settlegrid-api-key` header.
+
+## Development
+
+```bash
+npm run dev      # Start with hot reload (tsx watch)
+npm run build    # Compile TypeScript
+npm start        # Run compiled output
+```
+
+## Deploy
+
+Register your tool at [settlegrid.ai/dashboard/tools](https://settlegrid.ai/dashboard/tools) to start accepting payments.
+
+## Documentation
+
+- [SettleGrid Docs](https://settlegrid.ai/docs)
+- [@settlegrid/mcp SDK](https://www.npmjs.com/package/@settlegrid/mcp)

package/templates/rest-api/_dot_env.example

@@ -0,0 +1,4 @@
+SETTLEGRID_TOOL_SLUG={{TOOL_SLUG}}
+PORT=3000
+# Add your API keys here:
+# API_KEY=your-key-here

package/templates/rest-api/_dot_gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+.env
+*.tsbuildinfo

package/templates/rest-api/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "{{TOOL_SLUG}}",
+  "version": "1.0.0",
+  "description": "{{DESCRIPTION}}",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/server.ts",
+    "build": "tsc",
+    "start": "node dist/server.js"
+  },
+  "dependencies": {
+    "@settlegrid/mcp": "^0.1.1",
+    "express": "^4.21.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/templates/rest-api/src/server.ts

@@ -0,0 +1,46 @@
+import express from 'express'
+import { settlegrid } from '@settlegrid/mcp'
+
+const app = express()
+app.use(express.json())
+
+const sg = settlegrid.init({
+  toolSlug: '{{TOOL_SLUG}}', // Replace with your registered slug from settlegrid.ai
+  pricing: {
+    defaultCostCents: {{PRICE_CENTS}},
+    methods: {
+      'query': { costCents: {{PRICE_CENTS}}, displayName: 'Query' },
+    },
+  },
+})
+
+// Wrap your handler with SettleGrid billing
+const query = sg.wrap(
+  async (args: { query: string }) => {
+    // TODO: Implement your tool logic here
+    return { result: `Response for: ${args.query}` }
+  },
+  { method: 'query' }
+)
+
+// Routes
+app.post('/query', async (req, res) => {
+  try {
+    const result = await query(req.body)
+    res.json(result)
+  } catch (error) {
+    const message = error instanceof Error ? error.message : 'Internal server error'
+    res.status(500).json({ error: message })
+  }
+})
+
+// Health check (no billing)
+app.get('/health', (_req, res) => {
+  res.json({ status: 'ok', tool: '{{TOOL_SLUG}}', timestamp: new Date().toISOString() })
+})
+
+const PORT = process.env.PORT || 3000
+app.listen(PORT, () => {
+  console.log(`{{TOOL_NAME}} running at http://localhost:${PORT}`)
+  console.log(`Health check: http://localhost:${PORT}/health`)
+})

package/templates/rest-api/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}