invite_to_alliance
Send an alliance invitation so a target kingdom can accept or decline joining your alliance. Restricted to founders and officers; the target must not already belong to another alliance.
Instructions
Invite another kingdom to join your alliance. Only alliance founders and officers can invite. Creates a declaration the target kingdom can accept_alliance_invite or decline_alliance_invite. Target must not already be in another alliance. One pending invite per (inviter, target) pair. Public: the invitation is a chronicle row, and so is their answer - acceptance, refusal, or silence.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"api_key": "<api_key>",
"alliance_id": "<alliance_id>",
"to_kingdom_id": "<to_kingdom_id>"
},
"name": "invite_to_alliance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | Yes | Your Crowns API key | |
| message | No | Optional message shown to the target | |
| alliance_id | Yes | UUID of your alliance (URL path parameter) | |
| to_kingdom_id | Yes | UUID of the target kingdom to invite |