Skip to main content
Use the Tightknit MCP server to create a journey with milestones and a completion award, give awards to multiple members at once, and check member progress.

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.
If your agent supports skills (for example, Claude Code, Cursor, or Codex), install the Tightknit plugin and run /tightknit:onboarding-journey to build a journey, or /tightknit:give-award to give an award.

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:
  1. create_award: Creates the badge, profile photo frame, or certificate.
  2. create_journey: Creates the journey and sets the award as its completion award.
  3. add_milestone: Adds one milestone per call, up to 10 per journey.
  4. edit_journey: Activates the journey.
New journeys are inactive. Members can’t see or progress through a journey until you activate it. Active journeys and active awards count toward your plan’s limits.

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_assignments first.
  • 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_award uses the expensive budget of 20 calls per minute. A call with 25 members counts as one call. See Rate limits.

Journeys

Journey settings, milestone actions, and member progress.

Award and journey templates

Templates for common journeys and awards.