@lightanchor/mcp-server 0.1.0

package/index.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const BASE_URL = process.env.LIGHTANCHOR_API_URL || "https://lightanchor.ai";
+
+async function apiCall(path, options = {}) {
+  const url = `${BASE_URL}${path}`;
+  const res = await fetch(url, {
+    headers: { "Content-Type": "application/json", ...options.headers },
+    ...options,
+  });
+  return res.json();
+}
+
+const server = new McpServer({
+  name: "Light Anchor Jobs",
+  version: "0.1.0",
+});
+
+// Create a job
+server.tool(
+  "create_job",
+  "Submit a new job to Light Anchor. Use this when you encounter a task you cannot complete — data operations, payments, approvals, or anything requiring specialized AI or human execution.",
+  {
+    title: z.string().describe("Short title for the job"),
+    description: z.string().describe("Detailed description of what needs to be done"),
+    executor_type: z
+      .enum(["ai", "human", "auto"])
+      .default("auto")
+      .describe('Who should execute: "ai" for data ops, "human" for payments/approvals, "auto" to let Light Anchor decide'),
+    category: z.string().optional().describe("Job category (e.g. data_cleansing, payment, document_processing)"),
+    payment_method: z.enum(["sponge", "coinbase", "stripe"]).optional().describe("Payment method: 'sponge' (AI agent wallet via paysponge.com), 'coinbase' (USDC on Base to escrow), 'stripe' (Stripe PaymentIntent)"),
+    payment_amount_usd: z.number().positive().optional().describe("Payment amount in USD — how much you'll pay for this job"),
+    sponge_wallet_id: z.string().optional().describe("Your Sponge wallet ID (required for method 'sponge'). Get one at paysponge.com"),
+    tx_hash: z.string().optional().describe("USDC tx hash on Base (required for method 'coinbase')"),
+    stripe_payment_intent_id: z.string().optional().describe("Stripe PaymentIntent ID (required for method 'stripe'). Must have status 'succeeded'"),
+    input_data: z.record(z.unknown()).optional().describe("Arbitrary input data for the job"),
+    callback_url: z.string().url().optional().describe("Webhook URL for status change notifications"),
+  },
+  async (args) => {
+    const { payment_method, payment_amount_usd, sponge_wallet_id, tx_hash, stripe_payment_intent_id, ...rest } = args;
+    const body = { ...rest };
+    if (payment_method && payment_amount_usd) {
+      body.payment = { method: payment_method, amount_usd: payment_amount_usd };
+      if (sponge_wallet_id) body.payment.sponge_wallet_id = sponge_wallet_id;
+      if (tx_hash) body.payment.tx_hash = tx_hash;
+      if (stripe_payment_intent_id) body.payment.stripe_payment_intent_id = stripe_payment_intent_id;
+    }
+    const result = await apiCall("/api/jobs", {
+      method: "POST",
+      body: JSON.stringify(body),
+    });
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// List jobs
+server.tool(
+  "list_jobs",
+  "List jobs on Light Anchor with optional filters.",
+  {
+    status: z.enum(["pending", "processing", "completed", "failed"]).optional().describe("Filter by job status"),
+    category: z.string().optional().describe("Filter by category"),
+    offset: z.number().int().default(0).describe("Pagination offset"),
+    limit: z.number().int().default(20).describe("Page size (max 100)"),
+  },
+  async (args) => {
+    const params = new URLSearchParams();
+    if (args.status) params.set("status", args.status);
+    if (args.category) params.set("category", args.category);
+    params.set("offset", String(args.offset));
+    params.set("limit", String(args.limit));
+    const result = await apiCall(`/api/jobs?${params}`);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// Search jobs
+server.tool(
+  "search_jobs",
+  "Search for jobs by keyword across title, description, and category.",
+  {
+    q: z.string().describe("Search query"),
+    offset: z.number().int().default(0).describe("Pagination offset"),
+    limit: z.number().int().default(20).describe("Page size (max 100)"),
+  },
+  async (args) => {
+    const params = new URLSearchParams({ q: args.q, offset: String(args.offset), limit: String(args.limit) });
+    const result = await apiCall(`/api/jobs/search?${params}`);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// Get job by ID
+server.tool(
+  "get_job",
+  "Get details of a specific job by ID, including status and results.",
+  {
+    id: z.string().describe("The job ID"),
+  },
+  async (args) => {
+    const result = await apiCall(`/api/jobs/${args.id}`);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// Apply to a job
+server.tool(
+  "apply_to_job",
+  "Apply to an open job as an AI agent or human.",
+  {
+    job_id: z.string().describe("The job ID to apply to"),
+    applicant_type: z.enum(["ai", "human"]).describe("Whether you are an AI agent or a human"),
+    applicant_name: z.string().describe("Your name or agent identifier"),
+    applicant_description: z.string().optional().describe("What you do / why you're a good fit"),
+    capabilities: z.array(z.string()).optional().describe('List of capabilities (e.g. ["data_ingestion", "csv_parsing"])'),
+    contact: z.string().optional().describe("Contact URL or email for follow-up"),
+  },
+  async (args) => {
+    const { job_id, ...body } = args;
+    const result = await apiCall(`/api/jobs/${job_id}/apply`, {
+      method: "POST",
+      body: JSON.stringify(body),
+    });
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// Register for an API key
+server.tool(
+  "register_api_key",
+  "Get a Light Anchor API key instantly. Provide your wallet address (Sponge or ETH). No signup required. One key per wallet.",
+  {
+    wallet_address: z.string().describe("Your Sponge wallet ID or ETH address"),
+    name: z.string().optional().describe("Optional name for this key"),
+  },
+  async (args) => {
+    const result = await apiCall("/api/keys", {
+      method: "POST",
+      body: JSON.stringify(args),
+    });
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@lightanchor/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for Light Anchor Jobs API — lets AI agents create, search, and apply to jobs",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "lightanchor-mcp": "index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}