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

# Build journeys and give awards with the MCP

> Use the Tightknit MCP server to plan a member journey and recognize members with awards.

Use the Tightknit MCP server to create a [journey](https://docs.tightknit.ai/gamification/journeys.md) with milestones and a completion [award](https://docs.tightknit.ai/gamification/awards.md), give awards to multiple members at once, and check member progress.

## Prerequisites

* The Tightknit MCP server [connected to your agent](https://docs.tightknit.ai/integrations/mcp.md).
* The Admin role, or the **MCP User** role plus roles that can manage journeys and awards.
* To give awards, the give-awards permission.

> [!TIP]
>
> If your agent supports skills (for example, Claude Code, Cursor, or Codex), install the [Tightknit plugin](https://github.com/TightknitAI/tightknit-mcp-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

```text Build an onboarding journey theme={null}
Build an onboarding journey in my Tightknit community called "Getting Started".
Milestones:
- Join the Slack workspace
- Add a profile picture
- Post an introduction in #introductions
- React to 3 messages from other members
- Register for an event

When members complete it, give them a "Community Starter" badge with the
message "Welcome aboard, thanks for jumping in!". Use the attached image as
the badge.

Show me the plan before creating anything, and leave the journey inactive so
I can review it in Studio first. Give me the Studio links when you're done.
```

```text Give an award to a list of members theme={null}
Give the "Top Contributor" award to these members of my Tightknit community:
maria@example.com, dev@example.com, sam@example.com.
Use the message "Thank you for helping so many people this quarter."
Look the members up first and tell me if any of them can't be found.
```

```text Check journey progress theme={null}
How far have members gotten in the "Getting Started" journey? Show me which
milestone people get stuck on most, and list who has completed it this month.
```

## 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](https://docs.tightknit.ai/gamification/journeys.md#milestone-action-types). 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](https://docs.tightknit.ai/integrations/mcp.md#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](https://docs.tightknit.ai/gamification/journeys.md#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](https://docs.tightknit.ai/integrations/mcp.md#rate-limits).

## Related

> [card] [Journeys](https://docs.tightknit.ai/gamification/journeys.md)
>
> Journey settings, milestone actions, and member progress.

> [card] [Award and journey templates](https://docs.tightknit.ai/guides/award-and-journey-templates.md)
>
> Templates for common journeys and awards.


## Related topics

- [MCP Server](https://docs.tightknit.ai/integrations/mcp.md)
- [Awards](https://docs.tightknit.ai/gamification/awards.md)
- [Award and Journey Templates](https://docs.tightknit.ai/guides/award-and-journey-templates.md)
- [Automated Onboarding Journeys](https://docs.tightknit.ai/guides/set-up-automated-onboarding-journeys.md)
- [Getting Started with Gamification](https://docs.tightknit.ai/gamification/getting-started.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.