@usefillo/mcp 0.7.1 → 0.8.1

package/README.md

@@ -98,14 +98,18 @@ the named scope. With both, the login token wins — a key has no acting human.
 | Destinations | `fillo_get_integration`, `fillo_enable_integration`, `fillo_disable_integration`, `fillo_list_connections`, `fillo_select_connection`, `fillo_disconnect_integration`, `fillo_remove_connection_account`, `fillo_rename_discord_channel`, `fillo_hubspot_properties`, `fillo_hubspot_pipelines` | `integrations:manage` |
 | Responses and delivery | `fillo_list_held_responses`, `fillo_release_responses`, `fillo_delete_response`, `fillo_delivery_status`, `fillo_retry_deliveries`, `fillo_redeliver_responses`, `fillo_list_drafts`, `fillo_form_insights`, `fillo_list_respondents`, `fillo_delete_respondent` | `responses:manage`, `respondents:*`; `fillo_form_insights` needs `forms:read` **and** `responses:read` |
 | Webhooks | `fillo_list_webhooks`, `fillo_add_webhook`, `fillo_update_webhook`, `fillo_remove_webhook` | `webhooks:manage` |
-| Workspace | `fillo_rename_workspace`, `fillo_rename_project`, `fillo_get_branding`, `fillo_set_branding`, `fillo_list_members`, `fillo_invite_member`, `fillo_change_member_role`, `fillo_remove_member` | `workspace:manage`, `members:manage` |
+| Workspace | `fillo_rename_workspace`, `fillo_rename_project`, `fillo_get_branding`, `fillo_set_branding`, `fillo_get_billing`, `fillo_list_members`, `fillo_invite_member`, `fillo_change_member_role`, `fillo_remove_member` | `workspace:manage`, `members:manage` |
 | Credentials | `fillo_list_tokens`, `fillo_revoke_token`, `fillo_list_sync_tokens`, `fillo_create_sync_token`, `fillo_revoke_sync_token`, `fillo_list_api_keys`, `fillo_revoke_api_key`, `fillo_list_agents`, `fillo_revoke_agent` | `workspace:manage` |
 | Developer settings | `fillo_get_code_sync_policy`, `fillo_set_code_sync_policy`, `fillo_get_origins`, `fillo_set_origins`, `fillo_identity_status`, `fillo_enable_identity`, `fillo_disable_identity` | `workspace:manage` |
 
 `fillo_delete_form`, `fillo_get_branding`, `fillo_set_branding`,
-`fillo_list_api_keys`, and `fillo_revoke_api_key` need a login token — there is
-no project-API-key route for them, so a leaked key can never enumerate or revoke
-the workspace's credentials. `fillo_delete_response` needs one too, for a
+`fillo_get_billing`, `fillo_list_api_keys`, and `fillo_revoke_api_key` need a
+login token — there is no project-API-key route for them, so a leaked key can
+never enumerate or revoke the workspace's credentials or read its plan.
+`fillo_get_billing` is read-only: it reports the plan and this month's usage and
+returns the Settings link, but no tool can subscribe, change the plan, start a
+trial, or open checkout — an owner or admin does that in Settings → Billing &
+plan. `fillo_delete_response` needs one too, for a
 different reason: its scoped route takes no typed confirmation, so on a project
 API key the confirmation would be checked only by the caller, which is no
 confirmation at all.

package/dist/index.js

@@ -2523,6 +2523,7 @@ function registerWorkspaceAdmin(server) {
   registerRenameProject(server);
   registerGetBranding(server);
   registerSetBranding(server);
+  registerGetBilling(server);
   registerListMembers(server);
   registerInviteMember(server);
   registerSetMemberRole(server);
@@ -2656,6 +2657,64 @@ function registerSetBranding(server) {
     }
   );
 }
+var LONG_DATE = new Intl.DateTimeFormat("en-GB", {
+  day: "numeric",
+  month: "long",
+  year: "numeric",
+  timeZone: "UTC"
+});
+var COUNT = new Intl.NumberFormat("en-US");
+function isoDate(value) {
+  if (typeof value !== "string") return null;
+  const date = new Date(value);
+  return Number.isNaN(date.getTime()) ? null : LONG_DATE.format(date);
+}
+function billingSummary(json) {
+  const tier = typeof json?.tier === "string" ? `Everything ${json.tier}` : "Everything";
+  const plan = json?.plan === "free" ? "Free" : json?.plan === "trial" ? `${tier} trial` : json?.plan === "complimentary" ? `${tier}, complimentary` : json?.plan === "subscribed" ? `${tier}, billed ${json.interval === "year" ? "yearly" : "monthly"}` : "Plan unknown";
+  const parts = [plan];
+  const usage = json?.usage;
+  if (typeof usage?.responses === "number" && typeof json?.allowance === "number") {
+    parts.push(
+      `${COUNT.format(usage.responses)} of ${COUNT.format(json.allowance)} responses this month`
+    );
+  }
+  const periodEnd = isoDate(json?.currentPeriodEnd);
+  const trialEnd = isoDate(json?.trialEndsAt);
+  if (json?.plan === "subscribed" && json.status === "past_due") {
+    parts.push("the last payment failed; Stripe is retrying");
+  } else if (json?.plan === "subscribed" && periodEnd) {
+    parts.push(json.cancelAtPeriodEnd ? `cancels ${periodEnd}` : `renews ${periodEnd}`);
+  } else if (json?.plan === "trial" && trialEnd) {
+    parts.push(`trial ends ${trialEnd}`);
+  }
+  const manageUrl = typeof json?.manageUrl === "string" && /^https?:\/\//u.test(json.manageUrl) ? `: ${json.manageUrl}` : "";
+  return `${parts.join(" \xB7 ")}. Plan changes are made by an owner or admin in Settings \u2192 Billing & plan${manageUrl}`;
+}
+function registerGetBilling(server) {
+  server.registerTool(
+    "fillo_get_billing",
+    {
+      title: "Read the workspace's plan and usage",
+      description: "Report the workspace's plan (Free, trial, complimentary, or an Everything volume and billing period), this month's response count against its allowance, recent monthly usage, and the Settings link where an owner or admin changes the plan. Read-only: no tool can subscribe, change the plan, start a trial, or open checkout \u2014 report the numbers and hand the human manageUrl. Needs a LOGIN TOKEN \u2014 billing has no project-API-key route.",
+      inputSchema: {},
+      annotations: READ_ONLY
+    },
+    async () => {
+      const lane = resolveLane();
+      if (!lane) return noCredential("(login token only)");
+      if (lane.kind !== "cli") return LOGIN_ONLY("Reading the plan and usage");
+      const res = await laneFetch(lane, { path: "/workspace/billing" });
+      const problem = laneProblem(lane, res, {
+        scope: "(login token only)",
+        fallback: "Couldn't read the plan and usage",
+        missing: "This Fillo server doesn't report billing yet. Open Settings \u2192 Billing & plan to see the plan and usage."
+      });
+      if (problem) return problem;
+      return ok(billingSummary(res.json), res.json);
+    }
+  );
+}
 function registerInviteMember(server) {
   server.registerTool(
     "fillo_invite_member",
@@ -3267,7 +3326,20 @@ function registerRevokeAgentGrant(server) {
 }
 
 // src/tools/index.ts
+function withTitleAnnotations(server) {
+  const register = server.registerTool.bind(server);
+  server.registerTool = ((name, config, ...rest) => {
+    const annotations = config.annotations;
+    const title = typeof config.title === "string" ? config.title : void 0;
+    return register(
+      name,
+      title && annotations ? { ...config, annotations: { title, ...annotations } } : config,
+      ...rest
+    );
+  });
+}
 function registerTools(server) {
+  withTitleAnnotations(server);
   registerProvisionWorkspace(server);
   registerWhoami(server);
   registerProjects(server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usefillo/mcp",
-  "version": "0.7.1",
+  "version": "0.8.1",
   "mcpName": "io.github.jacobfunch/usefillo",
   "description": "Fillo MCP server — provision, scaffold, publish, and query forms from your coding agent.",
   "license": "MIT",