> ## Documentation Index
> Fetch the complete documentation index at: https://docs.theimmortals.pw/llms.txt
> Use this file to discover all available pages before exploring further.

# Spy operations

> Check spy counts, get targets, and run your daily spy ops

Spies win wars quietly. Train the maximum of 60 spies and buy more daily. These commands help you use them.

## Check a nation's spies

Run `/spies nation_id_or_link:<nation>`. The bot shows the nation's spy count, whether espionage is available against it, and a recommended operation: how many spies to send, what to hit, the projected odds, and the safety level.

## Get your spy targets

Run `/spy-targets` during a spy campaign. The bot lists enemy nations you can spy on right now, sorted by priority, each with a one-click espionage link and the recommended operation.

* `focus_damage`: set to true to prioritize damage operations over missiles and nukes.
* `nation_id_or_link`: generate the list for a different nation.

If the bot finds no targets in range, buy more spies.

## Ask for a hand-picked target

Run `/spy-target-request`. The bot posts your spy stats and pings the spy masters. They will assign you a target.

## Find spy attackers for a target

Run `/spy-counter` with the `target_nation_id_or_link` and `allied_alliances_or_coalitions` to search. Set `check_role` to true to only suggest members who have not done their ops today. The bot ranks the best-placed attackers and shows each one's spy count and war policy.

## Leadership: run the campaign

* `/spyfare update` regenerates the alliance spy assignment sheet for the chosen allied and enemy alliances.
* `/spyfare send` messages every member in game with a link to their live target list. Your API key is used only to send the messages and is not stored.
* `/spyfare send-assignments` messages each member their exact assignments from the sheet. The sheet must be fresh; regenerate it if it is more than a day old.
* `/spyfare set-sheet` registers the campaign sheet for the server.
* `/spyfare clear-did-not-spy-roles` resets the daily spy-tracking role for all members.