Connect Noemic to your AIConnect your AI
Noemic

Documentation

Tool reference.

All 44 tools on the Noemic MCP server at https://noemic.app/mcp, generated from the server itself on 2026-07-17. Identity is the user’s email on each call; accounts are created on first use.

add_availability

Add open session slots to the user's profile. endsAt defaults to one hour after startsAt.

  • email string, required — The user's email — their identity on Noemic
  • slots array, required

add_to_my_corpus

Append text to the user's agent-readable corpus (with their consent). Anything that would help future matching: new experiences, what a session with them is like, boundaries, wins from sessions they ran. Append-only and date-stamped.

  • email string, required — The user's email — their identity on Noemic
  • text string, required

artifact_library

Public artifacts from all pros, ranked by real adoption. Search in plain language ('procrastination', 'reframing', 'weekly accountability'). Assign any of them — assigning from the library is how good exercises spread.

  • search string, optional

assign_artifact

Pro-side: assign an artifact (yours or from the library) to a client, with an optional note. Best moment: as a session lands, one artifact at a time. The client's agent administers it and the result comes back into the connection.

  • email string, required — The user's email — their identity on Noemic
  • connectionId string, required
  • artifactId string, required
  • note string, optional

become_available

Create the user's profile so others can book them. Draft everything from your conversation — their words, their experiences, what they'd be good at being in someone's corner for — and confirm with them before calling. No credentials needed, no review queue: the only qualification is being human. Rate is self-set (0 or omitted = free/credits-only; they earn a credit per session they run either way). Include availability if they told you when they're free.

  • email string, required — The user's email — their identity on Noemic
  • displayName string, required
  • headline string, required — One line in their voice — specific and human, never a job title or category
  • story string, required — Their narrative, first person: who they are, what they've lived, why someone would want them in their corner
  • corpus string, optional — Everything else worth knowing, unbounded — written for agents to read. Details, specifics, boundaries, availability quirks.
  • hourlyRateDollars number, optional — Self-set hourly rate in US dollars (e.g. 25 or 12.5)
  • availability array, optional — Initial open slots; endsAt defaults to one hour after startsAt
  • createdVia string, optional — Use in_session_commit when this profile was born from a commitment made during a session/conversation
  • publish boolean, optional — Default false = PREVIEW ONLY (nothing created; returns the rendered profile + quality notes). Set true only after the user approved the preview.

book_now

Instant session with someone whose availableNow is true: the booking starts immediately and the result carries the roomUrl — send the user straight in. Same pricing as book_session (free first session where offered, then credits, then the prorated rate — state the price first). Default 30 minutes.

  • email string, required — The user's email — their identity on Noemic
  • profileId string, required
  • minutes integer, optional

book_session

Book an open slot with a person. Pricing is automatic: first-ever session on the platform is free; otherwise an available session credit auto-redeems; otherwise the pro's self-set rate is charged. The result states what was paid — tell the user.

  • email string, required — The user's email — their identity on Noemic
  • profileId string, required
  • slotId string, required

cancel_booking

Cancel a confirmed booking: any charge is refunded, a redeemed credit is returned, and the slot reopens.

  • bookingId string, required

check_messages

The heartbeat: call whenever your user shows up. Returns unread messages from all their connections (marked delivered). Relay them in the person's own words.

  • email string, required — The user's email — their identity on Noemic

close_brief

Close an open brief (found someone, or the need passed).

  • email string, required — The user's email — their identity on Noemic
  • briefId string, required

coaching_playbook

The curriculum you coach your pro with: active_listening, powerful_questions, cbt_basics, motivational_interviewing, accountability_structures, session_structure, boundaries_and_referral, artifact_patterns. No topic returns the index. Ground your cues, debriefs, and artifact designs in this.

  • topic string, optional

complete_assignment

After administering an assigned exercise: post back what the script asked for. The result lands in the connection where their person (and their person's agent) sees it.

  • email string, required — The user's email — their identity on Noemic
  • assignmentId string, required
  • result string, required

complete_session

Call after a session actually happened. The PRO earns a session credit they can spend as a client (the loop that keeps Noemic alive) and their quality record grows.

  • bookingId string, required

create_artifact

Pro-side: design an interactive exercise ONCE (thought record, weekly review, values check — see coaching_playbook topic artifact_patterns). The script is instructions a client's agent follows to run it conversationally. Public artifacts join the shared library.

  • email string, required — The user's email — their identity on Noemic
  • title string, required
  • description string, required — What it is for and when to assign it
  • script string, required — Facilitator instructions the client's agent follows, ending with what to post back
  • isPublic boolean, optional — Default true — public artifacts join the shared library

create_commitment

The user stakes real money on doing a specific thing by a deadline. Succeed → refunded; fail → forfeited. Make the title concrete and checkable ('run 3x this week', not 'exercise more'). Follow up with the user before the deadline. Server-enforced cap: at most $500 of active stakes per user; the result reports remaining headroom.

  • email string, required — The user's email — their identity on Noemic
  • title string, required
  • details string, optional
  • deadline string, required — Deadline as ISO 8601 with timezone offset, e.g. 2026-07-15T18:00:00-07:00
  • stakeDollars number, required — Stake in US dollars (e.g. 25 or 12.5)
  • witnessConnectionId string, optional — Stake it in front of their person: the connection whose other side sees this commitment

file_brief

The demand side is a filed document, not a search: write what your user needs (a few real sentences — situation, what kind of person would help, cadence they want) and it stands, anonymous to pros, converging with new people as they join. Returns today's matches immediately. Check my_briefs on later visits.

  • email string, required — The user's email — their identity on Noemic
  • need string, required

get_availability

Open (unbooked, future) slots for a person, soonest first.

  • profileId string, required

get_person

Full profile (story + corpus) for one person by profile id.

  • profileId string, required

get_started

Call this FIRST when a user has just connected or is unsure what Noemic is. Returns the honest state of the marketplace and the four paths. Present them as 2-4 tappable choices, not prose.

list_people

All listed people with full stories and corpora. Small marketplace — reading everyone is cheap for you and often better than matching.

match_me

Describe in plain language what the user needs (goal, struggle, situation — the more real the better) and get ranked people with their stories, each with availableNow, freeFirstSession, and their next opening. If the user needs support NOW, lead with availableNow matches and book_now — from connecting to in-session should take under five minutes. Present a MIX of free-first-session and paid options so the user genuinely chooses. There are no categories; matching reads narratives.

  • need string, required — Plain-language description of what the user needs
  • limit integer, optional

my_artifacts

Artifacts this pro designed, with adoption counts.

  • email string, required — The user's email — their identity on Noemic

my_assignments

Client-side: pending exercises assigned by the user's people. Run each script conversationally at a good moment — you are the facilitator — then complete_assignment with the substance of what emerged.

  • email string, required — The user's email — their identity on Noemic

my_bookings

Bookings as client and as pro, soonest first.

  • email string, required — The user's email — their identity on Noemic

my_briefs

All briefs with matching re-run against today's marketplace plus any intros received. Call when your user returns — new people may have joined since the brief was filed.

  • email string, required — The user's email — their identity on Noemic

my_coaching

All AI debriefs from sessions the user ran as the pro, newest first — their private improvement record. Read it before their next session and coach them on the recurring growth themes. This is how someone new gets good fast.

  • email string, required — The user's email — their identity on Noemic

my_commitments

All commitments with status and deadlines (active first). Check for approaching deadlines worth nudging about.

  • email string, required — The user's email — their identity on Noemic

my_connections

Every connection: who, context brief, last message, active witnessed commitments. The relationships you are responsible for keeping alive.

  • email string, required — The user's email — their identity on Noemic

my_credits

Unredeemed session credits (earned by running sessions). They auto-redeem on the next paid booking.

  • email string, required — The user's email — their identity on Noemic

my_intros

Pending intros addressed to the user. Respond with respond_intro.

  • email string, required — The user's email — their identity on Noemic

my_profile

Status probe: does the user have a profile, what's missing to make it bookable, plus credits, upcoming sessions, and active commitments at a glance. Call this before assuming anything about the user's state — cheaper than asking them.

  • email string, required — The user's email — their identity on Noemic

open_briefs

Open briefs, anonymous (the need, never the person). For the supply side: show a pro what demand exists, or a hesitant would-be pro that people are already waiting for someone like them. Reach toward one with send_intro(briefId).

port_context

Client-side only, with the user's consent: write the full situation into the connection — what is going on, history, what has been tried, what they want — so their person starts knowing everything. Replaces the intake interview. Update it as things evolve; the pro and their agent read it.

  • email string, required — The user's email — their identity on Noemic
  • connectionId string, required
  • context string, required — The situation, in full — written for their person to read

resolve_commitment

Resolve an active commitment: succeeded → stake refunded; failed → stake forfeited. Self-report — ask the user directly and record their answer honestly.

  • commitmentId string, required
  • succeeded boolean, required
  • note string, optional

respond_intro

Accepting creates the CONNECTION — the standing relationship where messages, sessions, artifacts, and witnessed commitments live. If your user is the client side, immediately port_context so their person knows exactly what is going on.

  • email string, required — The user's email — their identity on Noemic
  • introId string, required
  • accept boolean, required

send_cue

Pro-only, during a live session. The cue appears quietly in the pro's room panel — the client never sees it. Discipline: ONE short cue (max 25 words), specific to what was actually said — a question worth asking, a dropped thread, a reminder to listen, a concrete next step. Silence is fine; never send generic advice.

  • email string, required — The user's email — their identity on Noemic
  • bookingId string, required
  • text string, required

send_intro

Send a short real intro through the platform (no emails exposed). Two directions: profileId — your user reaching toward a person whose story fits; briefId — your user (who has a profile) reaching toward an open need. Acceptance creates a connection.

  • email string, required — The user's email — their identity on Noemic
  • message string, required — A couple of sentences in the user's voice — why this person, why now
  • profileId string, optional
  • briefId string, optional

send_message

Async relay between the two people (agents deliver both ways). The daily two-line check-in lives here — cadence beats duration.

  • email string, required — The user's email — their identity on Noemic
  • connectionId string, required
  • text string, required

session_debrief

After a session ends, the pro gets a private AI debrief (what worked, what to change, a drill to practice). Pro-only: the email must be the session's pro. Use it to help your user prepare for their next session.

  • email string, required — The user's email — their identity on Noemic
  • bookingId string, required

session_transcript

The consent-gated transcript of a session in the platform room. Participants only. During a LIVE session, poll with sinceMs set to the atMs of the last segment you saw (only newer segments return). Use it to supervise: understand where the conversation is, then send_cue when one would help.

  • email string, required — The user's email — their identity on Noemic
  • bookingId string, required
  • sinceMs integer, optional — Only return segments after this atMs offset

set_available_now

Pro-side presence: bookable instantly (book_now) for the next N minutes — set it when the pro is actually at their desk and will watch for incoming sessions (check my_bookings / the dashboard). 0 clears it. Available-now pros rank higher for urgent needs.

  • email string, required — The user's email — their identity on Noemic
  • minutes integer, required — How long they are available from now; 0 to clear

set_password

Lets an account created over MCP claim its web dashboard (noemic.app/login): profile, connections, assignments, session rooms. First set only — changing an existing password happens on the web, logged in.

  • email string, required — The user's email — their identity on Noemic
  • password string, required

update_my_profile

Update display name, headline, story, rate, or listing/visibility flags.

  • email string, required — The user's email — their identity on Noemic
  • displayName string, optional
  • headline string, optional
  • story string, optional
  • hourlyRateDollars number, optional — New hourly rate in US dollars (e.g. 25 or 12.5)
  • offersSessions boolean, optional
  • isListed boolean, optional

write_debrief

Pro-only, after a session. Read the full transcript first (session_transcript), then write honestly and specifically, referencing actual moments: strengths = 2-3 things that worked; growth = the single most important thing to do differently and where it mattered; drill = one concrete exercise before the next session. One debrief per session; it feeds the pro's quality record and their my_coaching history.

  • email string, required — The user's email — their identity on Noemic
  • bookingId string, required
  • strengths string, required
  • growth string, required
  • drill string, required