Developers · MCP
Use Mentornity from your AI assistant
Mentors and mentees can connect their own AI assistant to Mentornity. Ask it what is coming up this week, find a free time with your mentor and book it, answer a match request or fill in a mentoring tool, all in the conversation.
- Server URL
https://api.mentornity.com/mcp- Protocol
- MCP, Streamable HTTP
- Sign-in
- Your Mentornity account (OAuth)
- Cost
- Included for members
Connect your assistant
Every assistant needs the same server URL. When you add it, a Mentornity page opens: sign in, check which app is asking, and choose whether it may only look, or may also act for you. Nothing is shared until you press Connect.
Claude (claude.ai, desktop and mobile)
- Open Mentornity in Claude's connector directory (or Settings › Connectors › Browse connectors and search for Mentornity).
- Press Connect and approve on the Mentornity page. On Team and Enterprise plans an owner may need to enable the connector first.
Where the directory is not available, choose Add custom connector in Settings › Connectors, name it Mentornity and paste https://api.mentornity.com/mcp.
ChatGPT
- In plans that allow custom connectors, open Settings › Apps & Connectors and create a connector.
- Use
https://api.mentornity.com/mcpas the URL and OAuth as the authentication, then approve on the Mentornity page.
Claude Code
claude mcp add --transport http mentornity https://api.mentornity.com/mcpThen run /mcp in Claude Code and choose Authenticate.
Cursor
Add to ~/.cursor/mcp.json (or the project's .cursor/mcp.json), then sign in from Cursor's MCP settings:
{
"mcpServers": {
"mentornity": { "url": "https://api.mentornity.com/mcp" }
}
}VS Code
Add to .vscode/mcp.json and start the server from the file; VS Code opens the sign-in page:
{
"servers": {
"mentornity": { "type": "http", "url": "https://api.mentornity.com/mcp" }
}
}Other assistants
Any MCP client that supports remote servers with OAuth works: it registers itself, opens the Mentornity page for your approval, and receives a token only for you.
What it can do
The assistant works in every kind of programme (one-to-one and group mentoring, structured and free-form, mentor pools) and sees exactly what you see in the web app, in the programme's time zone.
Look things up
| Tool | What it does |
|---|---|
list_my_programs | Your programmes and your role in each. |
get_my_todo | What is waiting for you: upcoming meetings, meeting forms, match requests, to-do lists, forms, mentoring tools and events. |
get_program_guide | How a programme works: how matching works, who books meetings, meeting goals, limits. |
list_my_matches | Your mentors or mentees, and open match requests. |
search_mentors | Mentors you may choose, in programmes where mentees choose; can also find who is free on a given day. |
search_mentees | Mentees or teams in the programme (mentors). |
get_my_profile | Your headline, bio, your answers to the programme's profile questions, your team's profile, and which calendar and video accounts (Google, Microsoft, Zoom) you connected. |
get_member_profile | The profile of someone you can see in the programme, with their answers to the programme's profile questions; for a team or startup also its profile answers and members. |
find_meeting_slots | Free times in a mentor's published hours, in the programme's time zone. |
list_my_availability | Your published hours and blocked times, across programmes (mentors). |
list_meetings / get_meeting | Your upcoming and past meetings, and one meeting's details: who it is with (so their profiles can be read), the notes you may read and, in structured programmes, the before and after meeting forms. |
list_mentoring_tools / get_mentoring_tool | Mentoring tools assigned to you or by you, their answers, comments and review. |
list_tool_catalog | The mentoring tools a mentor can assign in the programme. |
list_conversations / read_conversation | Your message threads in the programme and their messages. |
list_tasks | The programme's to-do lists and your progress. |
list_posts | Programme posts and their comments. |
get_form | A form's questions, with a link to fill it in. |
Act for you (only if you allowed it)
| Tool | What it does |
|---|---|
book_meeting | Book a meeting in a free slot, or outside published hours where the programme allows it. |
reschedule_meeting | Move one of your meetings to another time. |
cancel_meeting | Cancel one of your meetings, with an optional reason. |
plan_meetings | Plan and book many meetings at once, e.g. Thursdays 9:00–17:00, 50 minutes each, around your calendar (mentors). |
add_availability / remove_availability | Publish or remove hours mentees can book (mentors). |
block_time / unblock_time | Block a time, e.g. all of tomorrow, in one or every programme (mentors). |
send_message | Send a message to a match, your team or a member of the programme. |
assign_mentoring_tool | Send a mentoring tool to your mentees, e.g. everyone you meet today (mentors). |
review_mentoring_tool / comment_on_mentoring_tool | Mark a handed-in tool reviewed, ask for it again, keep a private note, or comment. |
submit_form | Fill in a form or meeting form that is waiting for you. |
update_my_profile | Change your headline and bio. |
update_program_profile | Change your answers to the programme's profile questions. |
update_venture_profile | Change your team's or startup's profile. |
request_match | Choose a mentor, in programmes where mentees choose. |
withdraw_match_request | Take back a match request that is still waiting. |
respond_to_match_request | Accept or decline a match request (mentors). |
save_mentoring_tool_response | Fill in a mentoring tool, as a draft or handed in. |
set_task_item_done | Tick or untick an item on a to-do list. |
comment_on_post | Comment on a programme post, where comments are open. |
Some things stay in the web app: questions that need a file, date or phone number, signing up for events, visual mentoring tools (card sort, wheel, network), your photo and everything an admin does.
Your control
- Look-only by default. The assistant can act for you only if you tick Also let it act for me when you connect.
- Every change waits for your OK. The assistant first shows what will happen (who is told, how to undo it) and goes ahead only when you agree. The approval is tied to exactly that change and expires after 10 minutes.
- Only you. It acts as you, within your role in each programme, with the same rules and limits as the web app. It never sees your password and can do nothing as an admin.
- Other people's text is data. Profiles, posts and messages written by others are marked as such, so instructions hidden in them are not followed.
- Disconnect any time. Settings › AI assistants in Mentornity lists your connected assistants, what each did recently, and a Disconnect button that ends access at once. Changing your password or signing out everywhere also disconnects them.
Limits
| Limit | Default |
|---|---|
| Tool calls per connection per minute | 60 |
| Tool calls per person per day (UTC) | 2,000 |
| Changes (booked, cancelled, sent …) per person per hour | 20 |
| Changes per person per day (UTC) | 60 |
| Sign-in token lifetime | 1 hour, renewed automatically for 30 days of use |
Over a limit the assistant is told to wait; nothing is lost.
For programme admins
In the admin panel, Settings › Privacy › AI assistants turns access on or off for your programme. By default it is on, and off for programmes that use single sign-on or a partner brand. When it is off, members' assistants see that the programme exists but cannot read or change anything in it.
Troubleshooting
- "The admins have turned off access from AI assistants": the programme's switch is off; use the web app for it.
- "This connection may only read": you connected without Also let it act for me. Disconnect it in Settings › AI assistants and connect again with the box ticked.
- The approval page says the request expired: requests last 10 minutes. Start again from the assistant.
- Anything else: write to info@mentornity.com with the assistant's name and the time it happened.