@secondlayer/mcp 3.4.0 → 3.6.0

package/dist/bin.js

@@ -164,7 +164,8 @@ var PRODUCT_BLURBS = {
   contracts: "trait-based contract discovery",
   subgraphs: "author/deploy/query custom indexes",
   subscriptions: "webhook delivery on subgraph rows or raw chain events",
-  account: "identity, plan, billing, and API keys",
+  account: "identity, plan, billing, usage, spend caps, and API keys",
+  project: "create/manage projects and view their team",
   scaffold: "generate typed contract clients from a deployment or ABI"
 };
 var PRODUCT_ORDER = [
@@ -175,6 +176,7 @@ var PRODUCT_ORDER = [
   "subgraphs",
   "subscriptions",
   "account",
+  "project",
   "scaffold"
 ];
 function buildCapabilities() {
@@ -217,6 +219,8 @@ async function buildContext(deps = { clientProvider: getClient }) {
       indexTip: orNull(snap?.indexTip),
       subgraphs: snap?.subgraphs ? snap.subgraphs.map(formatSubgraphSummary) : unavailable,
       subscriptions: orNull(snap?.subscriptions),
+      projects: orNull(snap?.projects),
+      apiKeys: orNull(snap?.apiKeys),
       activeOperations: orNull(snap?.activeOperations)
     },
     whatYouCanDo: buildCapabilities(),
@@ -285,6 +289,23 @@ function registerAccountTools(server) {
     product: z.enum(["streams", "index"]).optional().describe("Key scope (default streams)"),
     name: z.string().optional().describe("Optional label for the key")
   }, async ({ product, name }) => jsonResponse(await getClient().apiKeys.create({ product, name })));
+  defineTool(server, "account_list_keys", "List the account's API keys (metadata only — prefix, name, status, product, tier, last used; never the plaintext). Requires an account-level (owner) API key.", {}, async () => jsonResponse(await getClient().apiKeys.list()));
+  defineTool(server, "account_revoke_key", "Revoke an API key by id. Requests using that key stop working immediately. Requires an account-level (owner) API key.", { id: z.string().describe("Key id from account_list_keys") }, async ({ id }) => jsonResponse(await getClient().apiKeys.revoke(id)));
+  defineTool(server, "account_usage", "Show the current billing period's usage snapshot: spend (with cap/projection), compute, storage, and per-project breakdown. Requires an API key.", {}, async () => jsonResponse(await apiRequest("GET", "/api/accounts/usage")));
+  defineTool(server, "account_get_caps", "Show the account's spend caps and alert threshold. Requires an account-level (owner) API key.", {}, async () => jsonResponse(await apiRequest("GET", "/api/billing/caps")));
+  defineTool(server, "account_set_caps", "Set the account's spend caps and alert threshold (no payment — just bounds spend). Requires an account-level (owner) API key.", {
+    monthlyCapCents: z.number().int().nonnegative().optional().describe("Total monthly spend cap in cents"),
+    computeCapCents: z.number().int().nonnegative().optional().describe("Compute spend cap in cents"),
+    storageCapCents: z.number().int().nonnegative().optional().describe("Storage spend cap in cents"),
+    alertThresholdPct: z.number().int().min(1).max(100).optional().describe("Percent of cap that triggers an alert (1-100)")
+  }, async (caps) => {
+    const body = {};
+    for (const [k, v] of Object.entries(caps)) {
+      if (v !== undefined)
+        body[k] = v;
+    }
+    return jsonResponse(await apiRequest("PATCH", "/api/billing/caps", body));
+  });
 }
 
 // src/tools/contracts.ts
@@ -306,7 +327,7 @@ function registerDatasetTools(server, clientProvider = getClient) {
     const catalog = await clientProvider().datasets.listDatasets();
     return jsonResponse(catalog);
   });
-  defineTool(server, "datasets_query", 'Query a cursor-paginated Foundation Dataset by slug (e.g. "stx-transfers", "sbtc/events", "pox-4/calls", "bns/events"). Filters are passed through as documented query params (e.g. {"sender": "SP...", "from_block": "150000"}). Returns { rows, next_cursor, tip }. Call datasets_list first to discover slugs.', {
+  defineTool(server, "datasets_query", 'Query ANY Foundation Dataset by slug — every family returned by datasets_list is queryable, including bespoke ones (bns/resolve with {"fqn":"alice.btc"}, bns/names, bns/namespaces, network-health/summary) and any dataset added later. Accepts family ("sbtc-events") or path ("sbtc/events") slug forms. Filters are passed through as documented query params (e.g. {"sender": "SP...", "from_block": "150000"}). Returns { rows, next_cursor, tip }; single-record datasets like bns/resolve return 0-or-1 rows (empty = not found). Call datasets_list first to discover slugs and their filters.', {
     slug: z3.string().describe("Dataset slug from datasets_list (e.g. stx-transfers)"),
     filters: z3.record(z3.string(), z3.string()).optional().describe("Documented per-dataset query params (snake_case values)"),
     limit: z3.number().optional().describe("Max rows for this page"),
@@ -317,7 +338,7 @@ function registerDatasetTools(server, clientProvider = getClient) {
       params.limit = limit;
     if (cursor !== undefined)
       params.cursor = cursor;
-    const result = await clientProvider().datasets.query(slug, params);
+    const result = await clientProvider().datasets.get(slug, params);
     return jsonResponse(result);
   });
 }
@@ -413,9 +434,43 @@ function registerIndexTools(server, clientProvider = getClient) {
   });
 }
 
+// src/tools/projects.ts
+import { z as z5 } from "zod/v4";
+function registerProjectTools(server, clientProvider = getClient) {
+  defineTool(server, "project_list", "List the account's projects. Requires an account-level (owner) API key.", {}, async () => jsonResponse(await clientProvider().projects.list()));
+  defineTool(server, "project_get", "Get a single project by slug.", { slug: z5.string().describe("Project slug") }, async ({ slug }) => jsonResponse(await clientProvider().projects.get(slug)));
+  defineTool(server, "project_create", "Create a project. The slug is derived from the name when omitted. Requires an account-level (owner) API key.", {
+    name: z5.string().describe("Project name"),
+    slug: z5.string().optional().describe("URL slug (auto-derived from name if omitted)"),
+    network: z5.string().optional().describe("Network (e.g. mainnet, testnet)"),
+    nodeRpc: z5.string().optional().describe("Custom node RPC URL")
+  }, async ({ name, slug, network, nodeRpc }) => jsonResponse(await clientProvider().projects.create({
+    name,
+    slug,
+    network,
+    nodeRpc
+  })));
+  defineTool(server, "project_update", "Update a project. `slug` selects the project; `newSlug` renames it. Requires an account-level (owner) API key.", {
+    slug: z5.string().describe("Slug of the project to update"),
+    newSlug: z5.string().optional().describe("New slug (renames the project)"),
+    name: z5.string().optional().describe("New display name"),
+    network: z5.string().optional().describe("Network (e.g. mainnet, testnet)"),
+    nodeRpc: z5.string().optional().describe("Custom node RPC URL"),
+    settings: z5.record(z5.string(), z5.unknown()).optional().describe("Arbitrary project settings to merge")
+  }, async ({ slug, newSlug, name, network, nodeRpc, settings }) => jsonResponse(await clientProvider().projects.update(slug, {
+    ...newSlug !== undefined ? { slug: newSlug } : {},
+    ...name !== undefined ? { name } : {},
+    ...network !== undefined ? { network } : {},
+    ...nodeRpc !== undefined ? { nodeRpc } : {},
+    ...settings !== undefined ? { settings } : {}
+  })));
+  defineTool(server, "project_delete", "Delete a project permanently. The account's last remaining project cannot be deleted.", { slug: z5.string().describe("Project slug") }, async ({ slug }) => jsonResponse(await clientProvider().projects.delete(slug)));
+  defineTool(server, "project_team_list", "List a project's team members and pending invitations.", { slug: z5.string().describe("Project slug") }, async ({ slug }) => jsonResponse(await clientProvider().projects.team(slug)));
+}
+
 // src/tools/scaffold.ts
 import { generateSubgraphCode } from "@secondlayer/scaffold";
-import { z as z5 } from "zod/v4";
+import { z as z6 } from "zod/v4";
 var API_BASE = process.env.SECONDLAYER_API_URL || "https://api.secondlayer.tools";
 async function fetchAbi(contractId) {
   const res = await fetch(`${API_BASE}/api/node/contracts/${contractId}/abi`, {
@@ -434,17 +489,17 @@ async function fetchAbi(contractId) {
 }
 function registerScaffoldTools(server) {
   defineTool(server, "scaffold_from_contract", "Generate a subgraph scaffold from a deployed Stacks contract. Fetches the ABI automatically.", {
-    contractId: z5.string().describe("Fully qualified contract ID (e.g. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01)"),
-    subgraphName: z5.string().optional().describe("Override the subgraph name (defaults to contract name)")
+    contractId: z6.string().describe("Fully qualified contract ID (e.g. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-pool-v2-01)"),
+    subgraphName: z6.string().optional().describe("Override the subgraph name (defaults to contract name)")
   }, async ({ contractId, subgraphName }) => {
     const { functions, maps } = await fetchAbi(contractId);
     const code = generateSubgraphCode(contractId, functions, subgraphName, maps);
     return { content: [{ type: "text", text: code }] };
   });
   defineTool(server, "scaffold_from_abi", "Generate a subgraph scaffold from a provided ABI JSON. Use when you already have the ABI.", {
-    abi: z5.string().describe("ABI JSON string (the full contract ABI object)"),
-    contractId: z5.string().describe("Fully qualified contract ID"),
-    subgraphName: z5.string().optional().describe("Override the subgraph name")
+    abi: z6.string().describe("ABI JSON string (the full contract ABI object)"),
+    contractId: z6.string().describe("Fully qualified contract ID"),
+    subgraphName: z6.string().optional().describe("Override the subgraph name")
   }, async ({ abi, contractId, subgraphName }) => {
     let parsed;
     try {
@@ -463,7 +518,7 @@ function registerScaffoldTools(server) {
 // src/tools/streams.ts
 import { AuthError } from "@secondlayer/sdk";
 import { DECODED_EVENT_TYPES as DECODED_EVENT_TYPES2 } from "@secondlayer/shared";
-import { z as z6 } from "zod/v4";
+import { z as z7 } from "zod/v4";
 var STREAMS_EVENT_TYPES = DECODED_EVENT_TYPES2;
 async function withStreamsAuthHint(fn) {
   try {
@@ -478,28 +533,28 @@ async function withStreamsAuthHint(fn) {
 function registerStreamsTools(server, clientProvider = getClient) {
   defineTool(server, "streams_tip", "Get the current Streams chain tip (latest processed block + lag). Streams requires an API key (SL_API_KEY).", {}, async () => withStreamsAuthHint(async () => jsonResponse(await clientProvider().streams.tip())));
   defineTool(server, "streams_events", "List raw chain events from the Streams firehose. Streams requires an API key (SL_API_KEY). Filter by event types, principals, contract, asset, or block range; page with cursor.", {
-    types: z6.array(z6.enum(STREAMS_EVENT_TYPES)).optional().describe("Event types to include"),
-    notTypes: z6.array(z6.enum(STREAMS_EVENT_TYPES)).optional().describe("Event types to exclude (applied after types)"),
-    contractId: z6.string().optional().describe("Filter by contract id"),
-    sender: z6.string().optional().describe("Filter by sender principal"),
-    recipient: z6.string().optional().describe("Filter by recipient principal"),
-    assetIdentifier: z6.string().optional().describe("Filter by asset identifier"),
-    fromHeight: z6.number().optional().describe("Start block height (inclusive)"),
-    toHeight: z6.number().optional().describe("End block height (inclusive)"),
-    cursor: z6.string().optional().describe("Opaque cursor from a prior response"),
-    limit: z6.number().optional().describe("Max events for this page")
+    types: z7.array(z7.enum(STREAMS_EVENT_TYPES)).optional().describe("Event types to include"),
+    notTypes: z7.array(z7.enum(STREAMS_EVENT_TYPES)).optional().describe("Event types to exclude (applied after types)"),
+    contractId: z7.string().optional().describe("Filter by contract id"),
+    sender: z7.string().optional().describe("Filter by sender principal"),
+    recipient: z7.string().optional().describe("Filter by recipient principal"),
+    assetIdentifier: z7.string().optional().describe("Filter by asset identifier"),
+    fromHeight: z7.number().optional().describe("Start block height (inclusive)"),
+    toHeight: z7.number().optional().describe("End block height (inclusive)"),
+    cursor: z7.string().optional().describe("Opaque cursor from a prior response"),
+    limit: z7.number().optional().describe("Max events for this page")
   }, async (params) => withStreamsAuthHint(async () => jsonResponse(await clientProvider().streams.events.list(params))));
   defineTool(server, "streams_consume", "Consume a bounded, reorg-aware run of Streams events from a cursor. Walks up to maxPages pages and returns the events, any reorgs observed, and a resume `cursor` to pass back as fromCursor next call — the agent-native consume/resume primitive. Streams requires an API key (SL_API_KEY).", {
-    fromCursor: z6.string().optional().describe("Resume cursor from a prior consume (omit to start at genesis)"),
-    types: z6.array(z6.enum(STREAMS_EVENT_TYPES)).optional().describe("Event types to include"),
-    notTypes: z6.array(z6.enum(STREAMS_EVENT_TYPES)).optional().describe("Event types to exclude"),
-    contractId: z6.string().optional().describe("Filter by contract id"),
-    sender: z6.string().optional().describe("Filter by sender principal"),
-    recipient: z6.string().optional().describe("Filter by recipient principal"),
-    assetIdentifier: z6.string().optional().describe("Filter by asset identifier"),
-    batchSize: z6.number().optional().describe("Events per page (1–1000, default 100)"),
-    maxPages: z6.number().optional().describe("Max pages to walk this call (1–20, default 5)"),
-    finalizedOnly: z6.boolean().optional().describe("Only emit finalized events; skip reorg handling")
+    fromCursor: z7.string().optional().describe("Resume cursor from a prior consume (omit to start at genesis)"),
+    types: z7.array(z7.enum(STREAMS_EVENT_TYPES)).optional().describe("Event types to include"),
+    notTypes: z7.array(z7.enum(STREAMS_EVENT_TYPES)).optional().describe("Event types to exclude"),
+    contractId: z7.string().optional().describe("Filter by contract id"),
+    sender: z7.string().optional().describe("Filter by sender principal"),
+    recipient: z7.string().optional().describe("Filter by recipient principal"),
+    assetIdentifier: z7.string().optional().describe("Filter by asset identifier"),
+    batchSize: z7.number().optional().describe("Events per page (1–1000, default 100)"),
+    maxPages: z7.number().optional().describe("Max pages to walk this call (1–20, default 5)"),
+    finalizedOnly: z7.boolean().optional().describe("Only emit finalized events; skip reorg handling")
   }, async (params) => withStreamsAuthHint(async () => {
     const maxPages = Math.min(Math.max(params.maxPages ?? 5, 1), 20);
     const batchSize = Math.min(Math.max(params.batchSize ?? 100, 1), 1000);
@@ -531,26 +586,27 @@ function registerStreamsTools(server, clientProvider = getClient) {
       pages: result.pages
     });
   }));
-  defineTool(server, "streams_event_by_txid", "List all Streams events emitted by a single transaction. Streams requires an API key (SL_API_KEY).", { txId: z6.string().describe("Transaction id (0x… hash)") }, async ({ txId }) => withStreamsAuthHint(async () => jsonResponse(await clientProvider().streams.events.byTxId(txId))));
+  defineTool(server, "streams_event_by_txid", "List all Streams events emitted by a single transaction. Streams requires an API key (SL_API_KEY).", { txId: z7.string().describe("Transaction id (0x… hash)") }, async ({ txId }) => withStreamsAuthHint(async () => jsonResponse(await clientProvider().streams.events.byTxId(txId))));
   defineTool(server, "streams_block_events", "List all Streams events in a single block, by height or block hash. Streams requires an API key (SL_API_KEY).", {
-    heightOrHash: z6.string().describe("Block height (digits) or block hash (0x… string)")
+    heightOrHash: z7.string().describe("Block height (digits) or block hash (0x… string)")
   }, async ({ heightOrHash }) => withStreamsAuthHint(async () => jsonResponse(await clientProvider().streams.blocks.events(/^\d+$/.test(heightOrHash) ? Number(heightOrHash) : heightOrHash))));
   defineTool(server, "streams_reorgs", "List chain reorgs observed by Streams since a cursor. Streams requires an API key (SL_API_KEY).", {
-    since: z6.string().describe("Cursor to list reorgs since (block:index or ISO timestamp)"),
-    limit: z6.number().optional().describe("Max reorgs to return")
+    since: z7.string().describe("Cursor to list reorgs since (block:index or ISO timestamp)"),
+    limit: z7.number().optional().describe("Max reorgs to return")
   }, async (params) => withStreamsAuthHint(async () => jsonResponse(await clientProvider().streams.reorgs.list(params))));
-  defineTool(server, "streams_canonical", "Get the canonical block at a given height from Streams (height + hashes + is_canonical). Streams requires an API key (SL_API_KEY).", { height: z6.number().describe("Block height") }, async ({ height }) => withStreamsAuthHint(async () => jsonResponse(await clientProvider().streams.canonical(height))));
+  defineTool(server, "streams_canonical", "Get the canonical block at a given height from Streams (height + hashes + is_canonical). Streams requires an API key (SL_API_KEY).", { height: z7.number().describe("Block height") }, async ({ height }) => withStreamsAuthHint(async () => jsonResponse(await clientProvider().streams.canonical(height))));
   defineTool(server, "streams_usage", "Your own Streams consumption (events today + this month) and tier limits (rate limit, retention). Streams requires an API key (SL_API_KEY).", {}, async () => withStreamsAuthHint(async () => jsonResponse(await clientProvider().streams.usage())));
 }
 
 // src/tools/subgraphs.ts
 import { bundleSubgraphCode } from "@secondlayer/bundler";
+import { ByoBreakingChangeError } from "@secondlayer/sdk";
 import {
   generateDrizzleSchema,
   generateKyselySchema,
   generatePrismaSchema
 } from "@secondlayer/subgraphs";
-import { z as z7 } from "zod/v4";
+import { z as z8 } from "zod/v4";
 function registerSubgraphTools(server, clientProvider = getClient) {
   defineTool(server, "subgraphs_list", "List all deployed subgraphs. Returns summary fields only.", {}, async () => {
     const { data } = await clientProvider().subgraphs.list();
@@ -563,16 +619,16 @@ function registerSubgraphTools(server, clientProvider = getClient) {
       ]
     };
   });
-  defineTool(server, "subgraphs_get", "Get full details of a subgraph including schema, health, and table columns.", { name: z7.string().describe("Subgraph name") }, async ({ name }) => {
+  defineTool(server, "subgraphs_get", "Get full details of a subgraph including schema, health, and table columns.", { name: z8.string().describe("Subgraph name") }, async ({ name }) => {
     const detail = await clientProvider().subgraphs.get(name);
     return {
       content: [{ type: "text", text: JSON.stringify(detail, null, 2) }]
     };
   });
   defineTool(server, "subgraphs_spec", "Get generated API documentation for a subgraph. Defaults to compact agent schema; supports OpenAPI JSON and Markdown.", {
-    name: z7.string().describe("Subgraph name"),
-    format: z7.enum(["agent", "openapi", "markdown"]).optional().describe("Spec format to return. Defaults to agent."),
-    serverUrl: z7.string().optional().describe("Override the server URL embedded in generated docs.")
+    name: z8.string().describe("Subgraph name"),
+    format: z8.enum(["agent", "openapi", "markdown"]).optional().describe("Spec format to return. Defaults to agent."),
+    serverUrl: z8.string().optional().describe("Override the server URL embedded in generated docs.")
   }, async ({ name, format = "agent", serverUrl }) => {
     const options = serverUrl ? { serverUrl } : undefined;
     const spec = format === "openapi" ? await clientProvider().subgraphs.openapi(name, options) : format === "markdown" ? await clientProvider().subgraphs.markdown(name, options) : await clientProvider().subgraphs.schema(name, options);
@@ -586,15 +642,15 @@ function registerSubgraphTools(server, clientProvider = getClient) {
     };
   });
   defineTool(server, "subgraphs_query", 'Query rows from a subgraph table (max 200 rows). Filters support operators: "amount.gte": "1000", "sender.neq": "SP...", "name.like": "%token%". Available operators: eq, neq, gt, gte, lt, lte, like.', {
-    name: z7.string().describe("Subgraph name"),
-    table: z7.string().describe("Table name"),
-    filters: z7.record(z7.string(), z7.string()).optional().describe('Column filters — plain values or with operators (e.g. {"amount.gte": "1000", "sender": "SP..."})'),
-    sort: z7.string().optional().describe("Column to sort by"),
-    order: z7.enum(["asc", "desc"]).optional().describe("Sort order"),
-    limit: z7.number().max(200).optional().describe("Max rows (default 50, max 200)"),
-    offset: z7.number().optional().describe("Offset for pagination"),
-    fields: z7.string().optional().describe('Comma-separated column list to return (e.g. "sender,amount")'),
-    count: z7.boolean().optional().describe("If true, return row count instead of rows")
+    name: z8.string().describe("Subgraph name"),
+    table: z8.string().describe("Table name"),
+    filters: z8.record(z8.string(), z8.string()).optional().describe('Column filters — plain values or with operators (e.g. {"amount.gte": "1000", "sender": "SP..."})'),
+    sort: z8.string().optional().describe("Column to sort by"),
+    order: z8.enum(["asc", "desc"]).optional().describe("Sort order"),
+    limit: z8.number().max(200).optional().describe("Max rows (default 50, max 200)"),
+    offset: z8.number().optional().describe("Offset for pagination"),
+    fields: z8.string().optional().describe('Comma-separated column list to return (e.g. "sender,amount")'),
+    count: z8.boolean().optional().describe("If true, return row count instead of rows")
   }, async ({
     name,
     table,
@@ -626,10 +682,25 @@ function registerSubgraphTools(server, clientProvider = getClient) {
       content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };
   });
+  defineTool(server, "subgraphs_aggregate", `Compute scalar aggregates over a subgraph table's filtered rows. Supports count, countDistinct, and sum/min/max (numeric columns only — uint/int plus the system _block_height). Filters use the same grammar as subgraphs_query (e.g. {"amount.gte": "1000"}). sum/min/max come back as lossless strings; counts as numbers. With no aggregate requested, returns the row count.`, {
+    name: z8.string().describe("Subgraph name"),
+    table: z8.string().describe("Table name"),
+    filters: z8.record(z8.string(), z8.string()).optional().describe('Column filters — plain values or with operators (e.g. {"amount.gte": "1000", "sender": "SP..."})'),
+    count: z8.boolean().optional().describe("Include COUNT(*) of matching rows"),
+    countDistinct: z8.array(z8.string()).optional().describe("Columns to count distinct values of"),
+    sum: z8.array(z8.string()).optional().describe("Numeric columns to sum (lossless string result)"),
+    min: z8.array(z8.string()).optional().describe("Numeric columns to take the minimum of"),
+    max: z8.array(z8.string()).optional().describe("Numeric columns to take the maximum of")
+  }, async ({ name, table, filters, count, countDistinct, sum, min, max }) => {
+    const result = await clientProvider().subgraphs.queryTableAggregate(name, table, { filters, count, countDistinct, sum, min, max });
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+    };
+  });
   defineTool(server, "subgraphs_reindex", "Reindex a subgraph from a specific block range. Returns an operationId — poll subgraphs_operation to track progress to completion.", {
-    name: z7.string().describe("Subgraph name"),
-    fromBlock: z7.number().optional().describe("Start block (defaults to beginning)"),
-    toBlock: z7.number().optional().describe("End block (defaults to latest)")
+    name: z8.string().describe("Subgraph name"),
+    fromBlock: z8.number().optional().describe("Start block (defaults to beginning)"),
+    toBlock: z8.number().optional().describe("End block (defaults to latest)")
   }, async ({ name, fromBlock, toBlock }) => {
     const result = await clientProvider().subgraphs.reindex(name, {
       fromBlock,
@@ -640,48 +711,100 @@ function registerSubgraphTools(server, clientProvider = getClient) {
     };
   });
   defineTool(server, "subgraphs_operation", "Check reindex/backfill progress. With operationId, returns that operation's status (poll until status is completed/failed/cancelled); without it, lists recent operations for the subgraph.", {
-    name: z7.string().describe("Subgraph name"),
-    operationId: z7.string().optional().describe("Operation id from reindex/backfill/stop; omit to list recent operations")
+    name: z8.string().describe("Subgraph name"),
+    operationId: z8.string().optional().describe("Operation id from reindex/backfill/stop; omit to list recent operations")
   }, async ({ name, operationId }) => {
     const result = operationId ? await clientProvider().subgraphs.getOperation(name, operationId) : await clientProvider().subgraphs.operations(name);
     return {
       content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };
   });
-  defineTool(server, "subgraphs_delete", "Delete a subgraph permanently.", { name: z7.string().describe("Subgraph name") }, async ({ name }) => {
-    const result = await clientProvider().subgraphs.delete(name);
-    return { content: [{ type: "text", text: result.message }] };
+  defineTool(server, "subgraphs_backfill", "Backfill a subgraph over a block range. Non-destructive forward fill (does not drop existing data) — unlike subgraphs_reindex, and the only data-fill path for BYO subgraphs (reindex is blocked there). Both blocks required. Returns an operationId — poll subgraphs_operation to track progress.", {
+    name: z8.string().describe("Subgraph name"),
+    fromBlock: z8.number().int().nonnegative().describe("Start block (inclusive)"),
+    toBlock: z8.number().int().nonnegative().describe("End block (inclusive)")
+  }, async ({ name, fromBlock, toBlock }) => {
+    const result = await clientProvider().subgraphs.backfill(name, {
+      fromBlock,
+      toBlock
+    });
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+    };
   });
-  defineTool(server, "subgraphs_deploy", "Deploy a subgraph from TypeScript code. Pass the full defineSubgraph() source — it will be bundled, validated, and deployed. Optional startBlock overrides the source definition for this deploy. Call `subgraphs_reindex` separately if you need a forced reindex.", {
-    code: z7.string().describe("TypeScript source code containing a defineSubgraph() call"),
-    startBlock: z7.number().int().nonnegative().optional().describe("Override the definition startBlock for this deploy")
-  }, async ({ code, startBlock }) => {
-    const bundled = await bundleSubgraphCode(code);
-    const result = await clientProvider().subgraphs.deploy({
-      name: bundled.name,
-      version: bundled.version,
-      description: bundled.description,
-      sources: bundled.sources,
-      schema: bundled.schema,
-      handlerCode: bundled.handlerCode,
-      sourceCode: code,
-      ...startBlock !== undefined ? { startBlock } : {}
+  defineTool(server, "subgraphs_stop", "Cancel an in-flight reindex or backfill operation for a subgraph. Returns the stop request status; poll subgraphs_operation to confirm it reaches a terminal state.", { name: z8.string().describe("Subgraph name") }, async ({ name }) => {
+    const result = await clientProvider().subgraphs.stop(name);
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+    };
+  });
+  defineTool(server, "subgraphs_gaps", "List indexing gaps (missing block ranges) for a subgraph. Each gap reports start/end/size, reason, and detected/resolved timestamps. Feed an unresolved gap's range into subgraphs_backfill to fill it. Defaults to unresolved gaps.", {
+    name: z8.string().describe("Subgraph name"),
+    limit: z8.number().int().positive().optional().describe("Max gaps to return"),
+    offset: z8.number().int().nonnegative().optional().describe("Pagination offset"),
+    resolved: z8.boolean().optional().describe("Filter by resolved state (omit for unresolved only)")
+  }, async ({ name, limit, offset, resolved }) => {
+    const result = await clientProvider().subgraphs.gaps(name, {
+      limit,
+      offset,
+      resolved
     });
     return {
       content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
     };
   });
-  defineTool(server, "subgraphs_read_source", "Fetch the deployed TypeScript source of a subgraph (plus its stored version). Returns a readOnly payload for subgraphs deployed before source capture — in that case the caller should redeploy via CLI before editing.", { name: z7.string().describe("Subgraph name") }, async ({ name }) => {
+  defineTool(server, "subgraphs_delete", "Delete a subgraph permanently.", { name: z8.string().describe("Subgraph name") }, async ({ name }) => {
+    const result = await clientProvider().subgraphs.delete(name);
+    return { content: [{ type: "text", text: result.message }] };
+  });
+  defineTool(server, "subgraphs_deploy", "Deploy a subgraph from TypeScript code. Pass the full defineSubgraph() source — it will be bundled, validated, and deployed. Optional startBlock overrides the source definition for this deploy. Set dryRun to validate and preview the schema/DDL without writing anything. Set databaseUrl to deploy to your own Postgres (BYO data plane) — the server verifies the connection first; with dryRun it returns the DDL + grant script. A breaking BYO schema change is refused and returns a migration plan (drop + rebuild DDL) instead of deploying. Call `subgraphs_reindex` separately if you need a forced reindex.", {
+    code: z8.string().describe("TypeScript source code containing a defineSubgraph() call"),
+    startBlock: z8.number().int().nonnegative().optional().describe("Override the definition startBlock for this deploy"),
+    databaseUrl: z8.string().optional().describe("BYO data plane: Postgres connection string to host the subgraph's schema and rows in your own database"),
+    dryRun: z8.boolean().optional().describe("Validate and preview the deploy (schema/DDL, BYO connection) without writing changes")
+  }, async ({ code, startBlock, databaseUrl, dryRun }) => {
+    const bundled = await bundleSubgraphCode(code);
+    try {
+      const result = await clientProvider().subgraphs.deploy({
+        name: bundled.name,
+        version: bundled.version,
+        description: bundled.description,
+        sources: bundled.sources,
+        schema: bundled.schema,
+        handlerCode: bundled.handlerCode,
+        sourceCode: code,
+        ...startBlock !== undefined ? { startBlock } : {},
+        ...databaseUrl !== undefined ? { databaseUrl } : {},
+        ...dryRun !== undefined ? { dryRun } : {}
+      });
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+      };
+    } catch (err) {
+      if (err instanceof ByoBreakingChangeError) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ byoBreakingChange: true, ...err.details }, null, 2)
+            }
+          ]
+        };
+      }
+      throw err;
+    }
+  });
+  defineTool(server, "subgraphs_read_source", "Fetch the deployed TypeScript source of a subgraph (plus its stored version). Returns a readOnly payload for subgraphs deployed before source capture — in that case the caller should redeploy via CLI before editing.", { name: z8.string().describe("Subgraph name") }, async ({ name }) => {
     const source = await clientProvider().subgraphs.getSource(name);
     return {
       content: [{ type: "text", text: JSON.stringify(source, null, 2) }]
     };
   });
   defineTool(server, "subgraphs_codegen", "Generate a typed ORM schema (Prisma, Drizzle, or Kysely) for a subgraph's tables so they can be queried from a BYO database. Pass either `code` (defineSubgraph source) or `name` (a deployed subgraph — its captured source is used). Returns the schema as text.", {
-    code: z7.string().optional().describe("defineSubgraph() source (mutually exclusive with name)"),
-    name: z7.string().optional().describe("Deployed subgraph name (mutually exclusive with code)"),
-    target: z7.enum(["prisma", "drizzle", "kysely"]).optional().describe("ORM target (default prisma)"),
-    schemaName: z7.string().optional().describe("Postgres schema name (defaults to subgraph_<name>)")
+    code: z8.string().optional().describe("defineSubgraph() source (mutually exclusive with name)"),
+    name: z8.string().optional().describe("Deployed subgraph name (mutually exclusive with code)"),
+    target: z8.enum(["prisma", "drizzle", "kysely"]).optional().describe("ORM target (default prisma)"),
+    schemaName: z8.string().optional().describe("Postgres schema name (defaults to subgraph_<name>)")
   }, async ({ code, name, target = "prisma", schemaName }) => {
     if (code && name || !code && !name) {
       throw new Error("Provide exactly one of `code` or `name`.");
@@ -710,7 +833,7 @@ function registerSubgraphTools(server, clientProvider = getClient) {
 
 // src/tools/subscriptions.ts
 import { CHAIN_TRIGGER_TYPES } from "@secondlayer/shared";
-import { z as z8 } from "zod/v4";
+import { z as z9 } from "zod/v4";
 function registerSubscriptionTools(server, clientProvider = getClient) {
   defineTool(server, "subscriptions_list", "List all subscriptions for the current account. Returns summary fields (no secrets).", {}, async () => {
     const { data } = await clientProvider().subscriptions.list();
@@ -718,34 +841,34 @@ function registerSubscriptionTools(server, clientProvider = getClient) {
       content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
     };
   });
-  defineTool(server, "subscriptions_get", "Get full detail for a subscription (filter, auth, retry config, circuit state).", { id: z8.string().describe("Subscription id") }, async ({ id }) => {
+  defineTool(server, "subscriptions_get", "Get full detail for a subscription (filter, auth, retry config, circuit state).", { id: z9.string().describe("Subscription id") }, async ({ id }) => {
     const detail = await clientProvider().subscriptions.get(id);
     return {
       content: [{ type: "text", text: JSON.stringify(detail, null, 2) }]
     };
   });
   defineTool(server, "subscriptions_create", "Create a subscription. Two kinds (mutually exclusive): a SUBGRAPH subscription fires on a subgraph table's rows (set subgraphName + tableName + optional filter); a CHAIN subscription fires on raw chain events with no subgraph (set triggers). Returns `signingSecret` ONCE — forward it to the user so they can wire it into their receiver.", {
-    name: z8.string().describe("Human-readable name, unique per account"),
-    subgraphName: z8.string().optional().describe("Subgraph to subscribe to (subgraph subscription)"),
-    tableName: z8.string().optional().describe("Table within the subgraph (subgraph subscription)"),
-    triggers: z8.array(z8.object({
-      type: z8.enum(CHAIN_TRIGGER_TYPES),
-      contractId: z8.string().optional(),
-      functionName: z8.string().optional(),
-      caller: z8.string().optional(),
-      sender: z8.string().optional(),
-      recipient: z8.string().optional(),
-      assetIdentifier: z8.string().optional(),
-      deployer: z8.string().optional(),
-      contractName: z8.string().optional(),
-      topic: z8.string().optional(),
-      lockedAddress: z8.string().optional(),
-      trait: z8.string().optional(),
-      minAmount: z8.union([z8.string(), z8.number()]).optional(),
-      maxAmount: z8.union([z8.string(), z8.number()]).optional()
+    name: z9.string().describe("Human-readable name, unique per account"),
+    subgraphName: z9.string().optional().describe("Subgraph to subscribe to (subgraph subscription)"),
+    tableName: z9.string().optional().describe("Table within the subgraph (subgraph subscription)"),
+    triggers: z9.array(z9.object({
+      type: z9.enum(CHAIN_TRIGGER_TYPES),
+      contractId: z9.string().optional(),
+      functionName: z9.string().optional(),
+      caller: z9.string().optional(),
+      sender: z9.string().optional(),
+      recipient: z9.string().optional(),
+      assetIdentifier: z9.string().optional(),
+      deployer: z9.string().optional(),
+      contractName: z9.string().optional(),
+      topic: z9.string().optional(),
+      lockedAddress: z9.string().optional(),
+      trait: z9.string().optional(),
+      minAmount: z9.union([z9.string(), z9.number()]).optional(),
+      maxAmount: z9.union([z9.string(), z9.number()]).optional()
     })).optional().describe("Chain triggers (chain subscription) — provide INSTEAD of subgraphName/tableName. Each targets a raw chain event/tx; string fields accept `*` wildcards, `trait` scopes to a SIP/trait. Forward-looking: starts at chain tip, no backfill."),
-    url: z8.string().describe("Webhook URL"),
-    format: z8.enum([
+    url: z9.string().describe("Webhook URL"),
+    format: z9.enum([
       "standard-webhooks",
       "inngest",
       "trigger",
@@ -753,8 +876,8 @@ function registerSubscriptionTools(server, clientProvider = getClient) {
       "cloudevents",
       "raw"
     ]).optional().describe("Wire format (default standard-webhooks)"),
-    runtime: z8.enum(["inngest", "trigger", "cloudflare", "node"]).optional().describe("Receiver runtime label (display only)"),
-    filter: z8.record(z8.string(), z8.unknown()).optional().describe('Scalar filter DSL, e.g. {"amount": {"gte": 100}, "sender": "SP..."}')
+    runtime: z9.enum(["inngest", "trigger", "cloudflare", "node"]).optional().describe("Receiver runtime label (display only)"),
+    filter: z9.record(z9.string(), z9.unknown()).optional().describe('Scalar filter DSL, e.g. {"amount": {"gte": 100}, "sender": "SP..."}')
   }, async (input) => {
     const res = await clientProvider().subscriptions.create(input);
     return {
@@ -762,10 +885,10 @@ function registerSubscriptionTools(server, clientProvider = getClient) {
     };
   });
   defineTool(server, "subscriptions_update", "Patch a subscription (url, filter, format, runtime, retry, timeout, concurrency).", {
-    id: z8.string(),
-    url: z8.string().optional(),
-    filter: z8.record(z8.string(), z8.unknown()).optional(),
-    format: z8.enum([
+    id: z9.string(),
+    url: z9.string().optional(),
+    filter: z9.record(z9.string(), z9.unknown()).optional(),
+    format: z9.enum([
       "standard-webhooks",
       "inngest",
       "trigger",
@@ -773,50 +896,50 @@ function registerSubscriptionTools(server, clientProvider = getClient) {
       "cloudevents",
       "raw"
     ]).optional(),
-    runtime: z8.enum(["inngest", "trigger", "cloudflare", "node"]).nullable().optional(),
-    maxRetries: z8.number().int().min(0).optional(),
-    timeoutMs: z8.number().int().min(100).optional(),
-    concurrency: z8.number().int().min(1).optional()
+    runtime: z9.enum(["inngest", "trigger", "cloudflare", "node"]).nullable().optional(),
+    maxRetries: z9.number().int().min(0).optional(),
+    timeoutMs: z9.number().int().min(100).optional(),
+    concurrency: z9.number().int().min(1).optional()
   }, async ({ id, ...patch }) => {
     const res = await clientProvider().subscriptions.update(id, patch);
     return {
       content: [{ type: "text", text: JSON.stringify(res, null, 2) }]
     };
   });
-  defineTool(server, "subscriptions_pause", "Pause a subscription. Pending rows remain queued until resumed.", { id: z8.string() }, async ({ id }) => {
+  defineTool(server, "subscriptions_pause", "Pause a subscription. Pending rows remain queued until resumed.", { id: z9.string() }, async ({ id }) => {
     const res = await clientProvider().subscriptions.pause(id);
     return {
       content: [{ type: "text", text: JSON.stringify(res, null, 2) }]
     };
   });
-  defineTool(server, "subscriptions_resume", "Resume a paused or circuit-open subscription and reset circuit failures.", { id: z8.string() }, async ({ id }) => {
+  defineTool(server, "subscriptions_resume", "Resume a paused or circuit-open subscription and reset circuit failures.", { id: z9.string() }, async ({ id }) => {
     const res = await clientProvider().subscriptions.resume(id);
     return {
       content: [{ type: "text", text: JSON.stringify(res, null, 2) }]
     };
   });
-  defineTool(server, "subscriptions_delete", "Delete a subscription. Pending outbox rows are cascade-deleted.", { id: z8.string() }, async ({ id }) => {
+  defineTool(server, "subscriptions_delete", "Delete a subscription. Pending outbox rows are cascade-deleted.", { id: z9.string() }, async ({ id }) => {
     const res = await clientProvider().subscriptions.delete(id);
     return {
       content: [{ type: "text", text: JSON.stringify(res, null, 2) }]
     };
   });
-  defineTool(server, "subscriptions_rotate_secret", "Rotate a subscription signing secret. Returns the new plaintext secret once.", { id: z8.string() }, async ({ id }) => {
+  defineTool(server, "subscriptions_rotate_secret", "Rotate a subscription signing secret. Returns the new plaintext secret once.", { id: z9.string() }, async ({ id }) => {
     const res = await clientProvider().subscriptions.rotateSecret(id);
     return {
       content: [{ type: "text", text: JSON.stringify(res, null, 2) }]
     };
   });
-  defineTool(server, "subscriptions_test", "Send a one-off test webhook to a subscription's URL (built for its format, SSRF-guarded). Logged as a delivery row — check subscriptions_recent_deliveries. Returns {ok, statusCode, error, durationMs, deliveryId}.", { id: z8.string().describe("Subscription id") }, async ({ id }) => {
+  defineTool(server, "subscriptions_test", "Send a one-off test webhook to a subscription's URL (built for its format, SSRF-guarded). Logged as a delivery row — check subscriptions_recent_deliveries. Returns {ok, statusCode, error, durationMs, deliveryId}.", { id: z9.string().describe("Subscription id") }, async ({ id }) => {
     const res = await clientProvider().subscriptions.test(id);
     return {
       content: [{ type: "text", text: JSON.stringify(res, null, 2) }]
     };
   });
   defineTool(server, "subscriptions_replay", "Replay a block range for a subscription. Replays run at 10% of batch capacity — use sparingly.", {
-    id: z8.string(),
-    fromBlock: z8.number().int().nonnegative(),
-    toBlock: z8.number().int().nonnegative()
+    id: z9.string(),
+    fromBlock: z9.number().int().nonnegative(),
+    toBlock: z9.number().int().nonnegative()
   }, async ({ id, fromBlock, toBlock }) => {
     const res = await clientProvider().subscriptions.replay(id, {
       fromBlock,
@@ -826,22 +949,22 @@ function registerSubscriptionTools(server, clientProvider = getClient) {
       content: [{ type: "text", text: JSON.stringify(res, null, 2) }]
     };
   });
-  defineTool(server, "subscriptions_dead", "Return the last 100 dead-letter outbox rows for a subscription.", { id: z8.string() }, async ({ id }) => {
+  defineTool(server, "subscriptions_dead", "Return the last 100 dead-letter outbox rows for a subscription.", { id: z9.string() }, async ({ id }) => {
     const { data } = await clientProvider().subscriptions.dead(id);
     return {
       content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
     };
   });
   defineTool(server, "subscriptions_requeue_dead", "Requeue one dead-letter outbox row for delivery retry.", {
-    id: z8.string(),
-    outboxId: z8.string()
+    id: z9.string(),
+    outboxId: z9.string()
   }, async ({ id, outboxId }) => {
     const res = await clientProvider().subscriptions.requeueDead(id, outboxId);
     return {
       content: [{ type: "text", text: JSON.stringify(res, null, 2) }]
     };
   });
-  defineTool(server, "subscriptions_recent_deliveries", "Return the last 100 delivery attempts (attempt #, status code, duration, truncated response).", { id: z8.string() }, async ({ id }) => {
+  defineTool(server, "subscriptions_recent_deliveries", "Return the last 100 delivery attempts (attempt #, status code, duration, truncated response).", { id: z9.string() }, async ({ id }) => {
     const { data } = await clientProvider().subscriptions.recentDeliveries(id);
     return {
       content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
@@ -861,6 +984,7 @@ function createServer() {
   registerSubgraphTools(server);
   registerSubscriptionTools(server);
   registerAccountTools(server);
+  registerProjectTools(server);
   registerDatasetTools(server);
   registerIndexTools(server);
   registerStreamsTools(server);
@@ -874,5 +998,5 @@ var server = createServer();
 var transport = new StdioServerTransport;
 await server.connect(transport);
 
-//# debugId=8433E24CA57D4D1D64756E2164756E21
+//# debugId=95B17975F7D570CF64756E2164756E21
 //# sourceMappingURL=bin.js.map