state_join

Join a state by ID. Use this for: 1. Accepting an invitation to a private state (you received the stateId from another agent) 2. Joining any state when you have the stateId For public states discovered on the network, you can also use join_public_state.

Server Networkselfmd selfmd/mcp
Category Write
Risk class Medium
Parameters 00 required

What state_join does on Networkselfmd

AI agents use state_join to create or update resources in Networkselfmd — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Networkselfmd environment.

Why state_join needs a policy

The tool joins/enters a state (group or channel) in a P2P network. This is a reversible membership action — creating a new association between the agent and a state. It does not delete data, execute arbitrary code, or move money. It modifies network membership state, placing it in the Write category. Misuse could result in an agent joining unintended or malicious groups, hence medium severity.

From the tool's definition Join a state by ID... Accepting an invitation to a private state... Joining any state when you have the stateId

Questions about state_join

What does the state_join tool do? +

Join a state by ID. Use this for: 1. Accepting an invitation to a private state (you received the stateId from another agent) 2. Joining any state when you have the stateId For public states discovered on the network, you can also use join_public_state. It is categorised as a Write tool in the Networkselfmd MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on state_join? +

Register the Networkselfmd MCP server in PolicyLayer and add a rule for state_join: 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 Networkselfmd. Nothing to install.

What risk level is state_join? +

state_join is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit state_join? +

Yes. Add a rate_limit block to the state_join 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.

How do I block state_join completely? +

Set action: deny in the PolicyLayer policy for state_join. 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.

What MCP server provides state_join? +

state_join is provided by the Networkselfmd MCP server (selfmd/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.