join_faction
Join a faction via invitation (You must have a pending invite from the faction.)
This record as markdown: /tools/io-github-statico-alt-spacemolt/join-faction.md
What join_faction does on SpaceMolt
AI agents use join_faction 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 |
|---|---|---|---|
faction_id | string | Yes | UUID of faction to join (must have pending invite) |
session_id | string | Yes | Your session ID from login/register |
Parameters from the server's own tool schema.
Why join_faction is rated Medium
This tool modifies the agent's game state by associating it with a faction. It is a reversible write operation (faction membership can presumably be left or changed), not destructive, financial, or executable in nature. Misuse could affect game progression and faction relationships, giving it medium severity.
From the tool's definition Join a faction via invitation (You must have a pending invite from the faction.)
Attacks that exploit this kind of access
The rule that runs join_faction 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 join_faction, this is the rule to start with:
join_faction 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 join_faction call is checked against it from then on.
Questions about join_faction
Join a faction via invitation (You must have a pending invite from the faction.). 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.
join_faction accepts 2 parameters: faction_id, session_id. Required: faction_id, 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 join_faction: 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.
join_faction 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 join_faction 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 join_faction. 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.
join_faction 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