Skip to main content
Glama
Sign In

OneLence

by com.onelence
OverviewDiscussionsAdmin

Update the business context

onelence_update_business_context
DestructiveIdempotent

Changes the workspace's business context (offer, sales cycle, order value, margin and acquisition-cost targets, notes). Only the fields passed change; each replaces the stored value and null clears one. Previous values are not kept. Owners and admins only. Two steps: call with the change to get a summary and a confirmation_id, show the summary to the user, and only after they agree call again with just confirmation_id.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "onelence_update_business_context"
  }
}

Input Schema

NameRequiredDescriptionDefault
notesNo
currencyNo
offer_typeNo
growth_modeNo
price_pointNo
sales_cycleNo
acceptable_cacNo
confirmation_idNoOnly when applying: the confirmation_id from the preview, after the user agreed.
learning_budgetNo
gross_margin_pctNo
market_familiarityNo
average_order_valueNo
payback_window_daysNo
conversion_readinessNo
annual_contract_valueNo
lead_to_customer_rate_pctNo

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "oneOf": [
+    {
+      "properties": {
+        "confirmation_id": {
+          "type": "string"
+        },
+        "expires_at": {
+          "type": "string"
+        },
+        "next_step": {
+          "type": "string"
+        },
+        "object": {
+          "const": "write_preview",
+          "type": "string"
+        },
+        "status": {
+          "const": "confirmation_required",
+          "type": "string"
+        },
+        "summary": {
+          "properties": {
+            "details": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "title": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "title",
+            "details"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "object",
+        "status",
+        "confirmation_id",
+        "expires_at",
+        "summary",
+        "next_step"
+      ],
+      "type": "object"
+    },
+    {
+      "properties": {
+        "object": {
+          "const": "write_result",
+          "type": "string"
+        },
+        "result": {
+          "anyOf": [
+            {
+              "properties": {
+                "acceptable_cac": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "annual_contract_value": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "average_order_value": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "conversion_readiness": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "currency": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "gross_margin_pct": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "growth_mode": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "lead_to_customer_rate_pct": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "learning_budget": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "market_familiarity": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "note": {
+                  "type": "string"
+                },
+                "notes": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "object": {
+                  "const": "business_context",
+                  "type": "string"
+                },
+                "offer_type": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "payback_window_days": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "price_point": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "sales_cycle": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "scope": {
+                  "enum": [
+                    "site",
+                    "workspace",
+                    "none"
+                  ],
+                  "type": "string"
+                },
+                "site": {
+                  "anyOf": [
+                    {
+                      "properties": {
+                        "domain": {
+                          "type": "string"
+                        },
+                        "id": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "domain"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "updated_at": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                }
+              },
+              "required": [
+                "object",
+                "scope",
+                "site",
+                "note",
+                "offer_type",
+                "market_familiarity",
+                "conversion_readiness",
+                "growth_mode",
+                "sales_cycle",
+                "price_point",
+                "currency",
+                "average_order_value",
+                "annual_contract_value",
+                "gross_margin_pct",
+                "acceptable_cac",
+                "lead_to_customer_rate_pct",
+                "payback_window_days",
+                "learning_budget",
+                "notes",
+                "updated_at"
+              ],
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "status": {
+          "const": "applied",
+          "type": "string"
+        }
+      },
+      "required": [
+        "object",
+        "status",
+        "result"
+      ],
+      "type": "object"
+    }
+  ],
+  "type": "object"
+}
  2. First observed

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations by disclosing the partial-update semantics, null-clears-a-field behavior, and that previous values are not retained — reinforcing destructiveHint=true. It also describes the two-step confirmation flow and what the first call returns (summary plus confirmation_id). It loses a point only because it doesn't state the outcome of a failed or stale confirmation_id.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four tight sentences, front-loaded with the mutation scope, then semantics, then permissions, then the procedure. Every sentence carries operational information with no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 16-param mutation with an output schema and rich annotations, the description covers permissions, partial-update behavior, irreversibility and the confirmation protocol — everything needed to call it safely. The remaining gap is the unlabeled parameters, whose meaning is left entirely to a nearly undocumented schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 6% and the description only explains confirmation_id indirectly plus the generic null/partial semantics. The 16 params — including enums like growth_mode, market_familiarity, conversion_readiness and numeric bounds on gross_margin_pct or lead_to_customer_rate_pct — get no per-field meaning, so an agent must guess at units and formats.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (changes the workspace's business context) and enumerates the covered fields — offer, sales cycle, order value, margin, CAC targets, notes. It also distinguishes itself from the read-side sibling by naming the mutation explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly names the prerequisite (owners and admins only) and the alternative path: use onelence_get_business_context to read, this tool to change. It also spells out the mandatory preview-then-apply sequence, which tells the agent exactly when each call form applies.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All OneLence toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources