Awards MCP tools
These tools are served by the Sessionboard MCP server. To connect an assistant, see Awards API authentication. Tools that read need read:awards; tools that change something need write:awards. Opening nominations, inviting reviewers and announcing winners reach people outside your team, so those three wait for a person’s OK before they run.
| Tool | Hints | Description |
|---|---|---|
get_awards_home | read | Awards Home: who the awards are for and what is being awarded |
list_awards_programs | read | Every Awards program: status, who can nominate and the review round’s dates |
get_awards_program | read | One program: its categories, the nomination form’s questions and the review round with its scorecard |
draft_awards_program | write | Draft a new program: name, and optionally a description, categories, nomination deadline and who can nominate |
update_awards_program | write · destructive | Change a program’s name, description, nomination deadline or who can nominate |
update_awards_scorecard | write · destructive | Replace the scorecard reviewers fill in (scores 1–5 or 1–10, comments); refused once anyone has scored |
open_awards_nominations | write · destructive | Open nominations: the program goes on the organization’s Awards Site with a public nomination form |
invite_awards_reviewers | write · destructive | Invite up to 50 reviewers to a program’s review round |
assign_awards_reviews | write | Give every submitted nomination its reviewers, spreading the load |
get_awards_results | read | Submissions, reviewers, scorecards filled in and winners, per program |
announce_awards_winners | write · destructive | Announce a program’s winners and finalists: whoever nominated them gets the news by email; waits for a person’s OK |
remind_awards | write · destructive | Remind reviewers with scorecards to finish, or people with unfinished nominations. Previews by default; the send waits for a person’s OK |
Your Awards Site
Edits land in the Awards Site’s draft; nothing goes live until publish_site, which an assistant calls only after the person has seen the changes and said OK. Reading needs read:sites or read:awards; changing needs write:sites or write:awards.
| Tool | Hints | Description |
|---|---|---|
list_sites | read | Your Sites, with whether each has unpublished changes |
get_site | read | One Site as its draft stands: pages, blocks, menu, theme, the block kinds it takes and the rules for editing |
make_site | write | Make an Awards Site from your programs and your Brand Kit, or rebuild a page from its address |
edit_site | write | Edit the draft: add, change, move, hide or remove pages and blocks; set the menu and the theme |
get_site_diff | read | What publishing would change, one plain sentence per change |
preview_site | read | A link to the draft as one role on one device, and what that role sees |
publish_site | write · destructive | Publish the draft once the person has said OK |
list_site_versions | read | Every published version, newest first |
restore_site_version | write · destructive | Copy an earlier version into the draft to review and publish |
discard_site_draft | write · destructive | Throw away the unpublished changes |