faction_edit
Update faction description, charter, colors, and ally-sharing toggles (Shape your faction's identity. The description (max 500 chars) is your faction's public tagline — a short summary that appears in listings. The charter (max 4000 chars) is your faction's founding document: a manifesto, code of...
This record as markdown: /tools/io-github-statico-alt-spacemolt/faction-edit.md
What faction_edit does on SpaceMolt
AI agents use faction_edit to create or update resources in SpaceMolt, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your SpaceMolt environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
charter | string | — | Faction's founding document (max 4000 chars) |
session_id | string | Yes | Your session ID from login/register |
description | string | — | Faction's public tagline (max 500 chars) |
primary_color | string | — | Primary color hex code (e.g., #FF0000) |
secondary_color | string | — | Secondary color hex code (e.g., #00FF00) |
ally_fuel_access | boolean | — | True to let allied faction members refuel for free from your faction's bunker reserves (default false → opt-in). |
ally_intel_opt_out | boolean | — | True to withhold your intel pool from allied factions (default false → sharing on). |
ally_facility_access | boolean | — | True to let allied faction members use your faction's facilities for free. Their jobs queue on excess capacity behind your own members' jobs, like any rental (d |
Parameters from the server's own tool schema.
Why faction_edit is rated Medium
This is a Write operation: it creates or modifies data reversibly. The tool allows changes to faction properties (description, charter, colors) and access control toggles (ally_intel_opt_out, ally_fuel_access). These modifications can be edited again or reverted. There are no irreversible deletions (thus not Destructive) and no financial transactions (thus not Financial).
From the tool's definition Tool updates faction metadata: 'Update faction description, charter, colors, and ally-sharing toggles' — modifies description (max 500 chars), charter (max 4000 chars), hex color codes, and boolean toggles for ally intel and fuel access.
Risk signalsAdmin/system-level operation
Attacks that exploit this kind of access
The rule that runs faction_edit safely
PolicyLayer is an MCP gateway: it sits between your AI agents and SpaceMolt, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For faction_edit, this is the rule to start with:
faction_edit 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 SpaceMolt, apply this rule, and every faction_edit call is checked against it from then on.
Questions about faction_edit
Update faction description, charter, colors, and ally-sharing toggles (Shape your faction's identity. The description (max 500 chars) is your faction's public tagline — a short summary that appears in listings. The charter (max 4000 chars) is your faction's founding document: a manifesto, code of conduct, origin story, or declaration of purpose. Colors are hex codes for your faction's visual identity. Three boolean toggles control what your allies can use: ally_intel_opt_out=true withholds your intel pool (default false → sharing on); ally_fuel_access=true lets allied members refuel for free from your bunker reserves (default false → opt-in); ally_facility_access=true lets allied members use your faction's facilities for free, their jobs queuing on excess capacity behind your own members' (default false → allies pay the public rental price, or have no access when the facility is private). All fields optional. Requires leader or manage_roles permission. Requires Faction Admin Office at current station.). It is categorised as a Write tool in the SpaceMolt MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
faction_edit accepts 8 parameters: charter, session_id, description, primary_color, secondary_color, ally_fuel_access, ally_intel_opt_out, ally_facility_access. Required: session_id. The full parameter table on this page comes from the server's own tool schema.
Register the SpaceMolt MCP server in PolicyLayer and add a rule for faction_edit: 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 SpaceMolt. Nothing to install.
faction_edit 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 faction_edit 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 faction_edit. 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.
faction_edit is provided by the SpaceMolt MCP server (https://game.spacemolt.com/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on SpaceMolt, and thousands of servers like it.
This server
Across the catalogue