eighty

metlem80/eighty-mcp-examples

Connects Claude to the eighty iOS app's live backend, exposing the same 35 API operations the mobile client uses: browse and create quests, update character stats, send social challenges, check leaderboards, view profiles. OAuth 2.1 with PKCE means no API keys. Your MCP session and your phone share one account in real time. Useful if you want an LLM to plan your day as RPG quests, coach you through them, or interact with eighty's social layer without opening the app. Most tools are free, challenges and extended leaderboard rows require Premium. The server is public at mcp.80l.app, this repo holds docs and example prompts.

tools: 35
transport: HTTP
last updated: May 11, 2026

View on GitHub

Tools

35 tools

Public tool metadata for what this MCP can expose to an agent.

browse_questsBrowse available quests. Returns a list of quests the user hasn't taken yet.

Browse available quests. Returns a list of quests the user hasn't taken yet.

No parameter schema in public metadata yet.

browse_quests_for_skillsBrowse quests that match the user's favorite skills.1 params

Browse quests that match the user's favorite skills.

Parameters* required

limitnumber

Max quests to return (default 10)

get_daily_questGet today's daily quest status. Returns the daily quest ID and completion status from the user's profile.

Get today's daily quest status. Returns the daily quest ID and completion status from the user's profile.

No parameter schema in public metadata yet.

get_quest_detailsGet full details of a quest including all steps and their completion status.1 params

Get full details of a quest including all steps and their completion status.

Parameters* required

questIdstring

The quest ID

take_questStart working on a quest. Changes the quest status to 'taken'. Free users can have up to 3 active quests.1 params

Start working on a quest. Changes the quest status to 'taken'. Free users can have up to 3 active quests.

Parameters* required

questIdstring

The quest ID to take

complete_quest_stepMark a single step of a quest as completed.2 params

Mark a single step of a quest as completed.

Parameters* required

questIdstring

The quest ID

stepIdstring

The step ID to complete

complete_questMark a quest as fully completed. All steps should be completed first.1 params

Mark a quest as fully completed. All steps should be completed first.

Parameters* required

questIdstring

The quest ID to complete

get_quest_historyView the user's past quest activities — completed, rejected, and in-progress quests.2 params

View the user's past quest activities — completed, rejected, and in-progress quests.

Parameters* required

limitnumber

Max results (default 20)

offsetnumber

Pagination offset (default 0)

create_questCreate a new quest draft with a title, description, and steps.3 params

Create a new quest draft with a title, description, and steps.

Parameters* required

descriptionstring

The quest description

stepsarray

List of steps for the quest

titlestring

The quest title

edit_questEdit an existing quest draft. Only the fields provided will be updated.4 params

Edit an existing quest draft. Only the fields provided will be updated.

Parameters* required

descriptionstring

New description (optional)

questIdstring

The quest ID to edit

stepsarray

New steps (optional)

titlestring

New title (optional)

publish_questPublish a quest draft, making it visible to other users.1 params

Publish a quest draft, making it visible to other users.

Parameters* required

questIdstring

The quest ID to publish

list_my_questsList quests created by the current user.2 params

List quests created by the current user.

Parameters* required

limitnumber

Max quests to return

offsetnumber

Pagination offset

get_skillsGet the full domain skills hierarchy available in the app.

Get the full domain skills hierarchy available in the app.

No parameter schema in public metadata yet.

get_skill_questsGet quests associated with a specific skill.2 params

Get quests associated with a specific skill.

Parameters* required

limitnumber

Max quests to return

skillIdstring

The skill ID

add_favorite_skillAdd a skill to your favorites. Favorited skills influence quest recommendations.1 params

Add a skill to your favorites. Favorited skills influence quest recommendations.

Parameters* required

skillIdstring

The skill ID to add to favorites

remove_favorite_skillRemove a skill from your favorites.1 params

Remove a skill from your favorites.

Parameters* required

skillIdstring

The skill ID to remove from favorites

get_profileGet the current user's profile information.

Get the current user's profile information.

No parameter schema in public metadata yet.

update_profileUpdate the current user's profile. Only the fields provided will be updated.3 params

Update the current user's profile. Only the fields provided will be updated.

Parameters* required

biostring

New bio (optional)

displayNamestring

New display name (optional)

usernamestring

New username (optional)

get_badgesGet the current user's earned badges.

Get the current user's earned badges.

No parameter schema in public metadata yet.

get_activity_timelineGet the current user's activity timeline, showing recent actions and events.2 params

Get the current user's activity timeline, showing recent actions and events.

Parameters* required

limitnumber

Max activities to return

offsetnumber

Pagination offset

follow_userFollow another user by their user ID.1 params

Follow another user by their user ID.

Parameters* required

userIdstring

The user ID to follow

unfollow_userUnfollow a user by their user ID.1 params

Unfollow a user by their user ID.

Parameters* required

userIdstring

The user ID to unfollow

get_followersGet the list of followers for a user. Defaults to the authenticated user if no userId is provided.3 params

Get the list of followers for a user. Defaults to the authenticated user if no userId is provided.

Parameters* required

cursorstring

Pagination cursor

limitnumber

Max results to return

userIdstring

User ID to get followers for (defaults to current user)

get_followingGet the list of users that a user is following. Defaults to the authenticated user if no userId is provided.3 params

Get the list of users that a user is following. Defaults to the authenticated user if no userId is provided.

Parameters* required

cursorstring

Pagination cursor

limitnumber

Max results to return

userIdstring

User ID to get following list for (defaults to current user)

get_feedGet the activity feed for the authenticated user, showing activity from people they follow.2 params

Get the activity feed for the authenticated user, showing activity from people they follow.

Parameters* required

cursorstring

Pagination cursor

limitnumber

Max results to return

likeLike a piece of content (e.g. a quest completion).2 params

Like a piece of content (e.g. a quest completion).

Parameters* required

targetIdstring

The ID of the content to like

targetTypestring

The type of content to likeone of questCompletion

unlikeRemove a like from a piece of content.2 params

Remove a like from a piece of content.

Parameters* required

targetIdstring

The ID of the content to unlike

targetTypestring

The type of content to unlikeone of questCompletion

view_public_profileView a user's public profile by their username — returns the same rich payload the iOS app shows on tap (level, stats, streaks, badges, completed quests, follower/following counts).1 params

View a user's public profile by their username — returns the same rich payload the iOS app shows on tap (level, stats, streaks, badges, completed quests, follower/following counts).

Parameters* required

usernamestring

The username to look up

list_quest_takersList users who have taken or completed a specific quest.3 params

List users who have taken or completed a specific quest.

Parameters* required

limitnumber

Max results (default 20)

offsetnumber

Pagination offset

questIdstring

The quest ID

search_usersSearch for users by name or username.2 params

Search for users by name or username.

Parameters* required

limitnumber

Max results (default 10)

querystring

Search query (name or username)

send_challengeSend a challenge to another user to complete a quest. Requires eighty Premium.4 params

Send a challenge to another user to complete a quest. Requires eighty Premium.

Parameters* required

questIdstring

The quest ID to challenge them with

questTitlestring

The title of the quest (denormalized for display in the challenged user's inbox)

timeLimitstring

Time limit for the challengeone of 24h · 48h · 7d · none

userIdstring

The user ID to challenge

respond_to_challengeAccept or decline a challenge you have received. Requires eighty Premium.2 params

Accept or decline a challenge you have received. Requires eighty Premium.

Parameters* required

challengeIdstring

The challenge ID to respond to

responsestring

Whether to accept or decline the challengeone of accept · decline

list_challengesList challenges you have sent (you are the challenger) or received (you are the challenged). Requires eighty Premium.3 params

List challenges you have sent (you are the challenger) or received (you are the challenged). Requires eighty Premium.

Parameters* required

limitnumber

Max results to return

offsetnumber

Pagination offset

rolestring

Whose perspective: 'sent' = challenges you sent, 'received' = challenges sent to youone of sent · received

get_challenge_detailsGet full details of a specific challenge. Requires eighty Premium.1 params

Get full details of a specific challenge. Requires eighty Premium.

Parameters* required

challengeIdstring

The challenge ID to retrieve

get_leaderboardGet the global leaderboard. Free users are capped at 10 results; Premium users can retrieve up to 50.2 params

Get the global leaderboard. Free users are capped at 10 results; Premium users can retrieve up to 50.

Parameters* required

limitnumber

Max results to return (free users capped at 10, premium up to 50)

offsetnumber

Pagination offset

Readme

eighty MCP — docs, prompts, and screenshots

A public Model Context Protocol server that lets any MCP-compatible client — Claude Desktop, Claude.ai Connectors, Cursor, ChatGPT Apps, MCP Inspector — read and write a real-life RPG character sheet.

The server is live at https://mcp.80l.app. This repo is the documentation, example prompts, and reference screenshots — not the server source.

MCP Inspector connected to mcp.80l.app, showing the eighty tool catalog

What is this

View the full README on GitHub

Details

Repository: github.com/metlem80/eighty-mcp-examples
Website: 80l.app
Transport: HTTP
Registry: MCP registry, active