append_cos_preference
Append one durable speech/taste preference for THIS operator only (re-injected on their next voice session mint). Use when they say something was hard to follow, how cards should sound, or "remember I prefer…". For this user_id only — does not edit the shared FreedomOS CoS template. Apply the not...
This record as markdown: /tools/com-getfreedomos-freedom-mcp/append-cos-preference.md
What append_cos_preference does on Freedom Mcp
AI agents use append_cos_preference to create or update resources in Freedom Mcp, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Freedom Mcp environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
note | string | Yes | One short preference (≤500 chars), e.g. "When describing cards, paraphrase titles — do not read dashes or ids aloud." |
companyId | string | — | FreedomOS company id to act within (you must be a member). Required for company-scoped tools. |
Parameters from the server's own tool schema.
Why append_cos_preference is rated Medium
This tool creates or modifies user-specific preference data (appends a preference record that persists across sessions). It is reversible and has no destructive, financial, or code-execution properties. The scope is limited to individual operator preferences with no blast radius beyond personalization settings. The note that first use may require manager approval confirms it is a Write operation (not Execute).
From the tool's definition Append one durable speech/taste preference for THIS operator only... Use when they say something was hard to follow, how cards should sound, or 'remember I prefer…'. For this user_id only — does not edit the shared FreedomOS CoS template.
Attacks that exploit this kind of access
The rule that runs append_cos_preference safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Freedom Mcp, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For append_cos_preference, this is the rule to start with:
append_cos_preference stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Freedom Mcp, apply this rule, and every append_cos_preference call is checked against it from then on.
Questions about append_cos_preference
Append one durable speech/taste preference for THIS operator only (re-injected on their next voice session mint). Use when they say something was hard to follow, how cards should sound, or "remember I prefer…". For this user_id only — does not edit the shared FreedomOS CoS template. Apply the note in the current call when you can. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next time.]. It is categorised as a Write tool in the Freedom Mcp MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
append_cos_preference accepts 2 parameters: note, companyId. Required: note. The full parameter table on this page comes from the server's own tool schema.
Register the Freedom MCP server in PolicyLayer and add a rule for append_cos_preference: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Freedom Mcp. Nothing to install.
append_cos_preference is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the append_cos_preference rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for append_cos_preference. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
append_cos_preference is provided by the Freedom MCP server (https://twuluxmoognlwtmaoqgo.supabase.co/functions/v1/freedom-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Freedom, and thousands of servers like it.
This server
Across the catalogue