Prerequisites
- The Tightknit MCP server connected to your agent.
- The Admin role, or the MCP User role plus roles that can manage journeys and awards.
- To give awards, the give-awards permission.
How journeys, milestones, and awards work
A journey is a set of milestones. Each milestone tracks one member action, such as joining the workspace or posting in a channel. Members can complete milestones in any order. When a member completes every milestone, they receive the journey’s completion award. The agent creates these in order, because each step uses the ID returned by the previous one:create_award: Creates the badge, profile photo frame, or certificate.create_journey: Creates the journey and sets the award as its completion award.add_milestone: Adds one milestone per call, up to 10 per journey.edit_journey: Activates the journey.
Example prompts
Build an onboarding journey
Give an award to a list of members
Check journey progress
Build a journey and give awards
1
Describe the milestones
Describe each milestone as a member action. The agent matches it to a milestone action type. Include a count for repeatable actions (“react to 3 messages”) and a channel for channel-based actions (“post in #introductions”). The Join a specific Slack channel action requires a channel.
2
Define the award
An award can include a badge image and a profile photo frame. Certificates are available on some plans. You can also choose a Slack channel where the award is announced.The agent can upload images you provide. Its sandbox needs network access to the Tightknit upload domain. See Files.
3
Review and activate the journey
Ask the agent to leave the journey inactive and share the Studio links. Review the milestones and their order in Studio, then ask the agent to activate the journey.
4
Give awards
The agent looks up members by name or email with
list_members, then calls give_award. Each call accepts up to 25 members. Each recipient gets a DM, and the award is announced in Slack. Members who can’t receive the award, such as deactivated members, are skipped and listed in the response.Notes
- Editing an active journey: Adding, removing, or changing milestones on an active journey affects members’ progress. See Modifying milestones of an active journey before you make changes.
- Repeat awards: A member can receive the same award more than once, and each one is recorded and announced. To give it only to members who don’t have it yet, ask the agent to check
list_award_assignmentsfirst. - Who can give awards: Only admins can give awards, unless the award allows non-admins to give it and your plan includes that option.
- Deleting: Deleting a journey deletes its milestones and all member progress. Deleting an award deletes every record of it being given. You can’t undo either action. To pause a journey, deactivate it instead.
- Rate limits:
give_awarduses the expensive budget of 20 calls per minute. A call with 25 members counts as one call. See Rate limits.
Related
Journeys
Journey settings, milestone actions, and member progress.
Award and journey templates
Templates for common journeys and awards.

