find_route
Find the shortest route to a destination system, POI, or base (Uses BFS to find the shortest path from your current system. Accepts a system ID, POI ID, or base ID. If a POI or base is given, the response includes target_poi and target_poi_name for the final travel step within the destination sys...
This record as markdown: /tools/io-github-statico-alt-spacemolt/find-route.md
What find_route does on SpaceMolt
AI agents call find_route to retrieve information from SpaceMolt without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
session_id | string | Yes | Your session ID from login/register |
target_system | string | Yes | ID of the destination system. Use search_systems to find system IDs by name. |
Parameters from the server's own tool schema.
Why find_route is rated Low
find_route queries navigation information and returns planning data (route steps, fuel costs, wormhole details) to help the agent plan travel. It performs no writes, deletions, or side effects—it only computes and returns read-only navigation metadata. The tool explicitly states it 'uses BFS to find the shortest path' and returns response data, confirming it is a passive retrieval operation with no state changes.
From the tool's definition Tool "Find the shortest route to a destination system, POI, or base (Uses BFS to find the shortest path from your current system...Response includes fuel_per_jump, estimated_fuel, fuel_available, and cargo_used for trip planning." This is purely informational…
Attacks that exploit this kind of access
The rule that runs find_route 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 find_route, this is the rule to start with:
find_route is read-only, so it stays allowed. 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 find_route call is checked against it from then on.
Questions about find_route
Find the shortest route to a destination system, POI, or base (Uses BFS to find the shortest path from your current system. Accepts a system ID, POI ID, or base ID. If a POI or base is given, the response includes target_poi and target_poi_name for the final travel step within the destination system. Use search_systems to find system IDs. Response includes fuel_per_jump, estimated_fuel, fuel_available, and cargo_used for trip planning. Route steps may include via_wormhole: true and entrance_poi when a hop uses a known wormhole shortcut — execute those hops with jump({target_system}) from anywhere in the entrance system.). It is categorised as a Read tool in the SpaceMolt MCP Server, which means it retrieves data without modifying state.
find_route accepts 2 parameters: session_id, target_system. Required: session_id, target_system. 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 find_route: 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.
find_route is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the find_route 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 find_route. 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.
find_route 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