MCP servercom.youspot/youspot

Add an emoji reaction (by name, e.g. 'eyes' or 'white_check_mark') to a Slack message.

The raw material for an engagement analysis of the user's most recent LinkedIn posts: per-post stats, a sample of the actual comments left on them (who said what), and the LinkedIn

Archive one Gmail message: it leaves the inbox but stays in All Mail, fully recoverable. Use only when the user asked for the archive; confirm first if it's your own suggestion. On

Ask a free-form question about the user's LinkedIn connections that the other tools can't express: aggregates and rankings ('which companies do I know the most people at?'), date r

Query the user's HubSpot companies — the companies synced from the HubSpot portals they've connected. Use this for any question about their CRM companies: firmographics ('software

Query the user's HubSpot contacts — the people synced from the HubSpot portals they've connected. Use this for any question about their CRM contacts: engagement filters ('show me p

Ask a question about the user's LinkedIn invitations — the requests they sent and received. This is the only tool that can see invitations. Use it for questions like 'which invitat

What is clogging up the user's brain: how many objects they hold of each type, how much of it is a log of the machine working rather than anything they know, the people capture min

Cancel a text that was scheduled with send_text_to_user and has not been sent yet. Takes the task_id from the scheduling response or from list_scheduled_texts.

Check whether a public web page has changed since the last time this was called for it, and get the diff. Use for watching one page over time: a company's team or leadership page,

Check one person's LinkedIn profile and report what has changed since the last check — a new headline, a new company, a move, or going open to work. Takes a LinkedIn username or pr

Record which publications the owner wants read into their brain, and which they do not. Only a sender listed here as allowed is ever read, so nothing enters the brain the owner has

Recent news and hiring movement for companies the user already knows, several at once, split into what is new since the last check and what was already reported. Use for watching c

Connect two objects in the user's graph with a directed edge — e.g. connect a file or note to a project, a person to a company, a web link to an event. Use the object_ids that crea

Create a brand kit by hand in the user's active space from what the user gave. Only name is required; colors, fonts and radius left out start from the YouSpot kit. Logos are upload

Prepare or queue one calendar event through the shared suggestion service. Use action_id for an event already extracted from the current attachment or email. Source documents never

Create a DRAFT email in the user's connected Gmail mailbox, addressed to anyone ('draft an email to [email protected] about X'). Nothing is sent: the draft lands in Gmail's Drafts fold

Create a new object in the user's graph. Use when they ask to add something — a project, note, fact, web link, person, company, product, event, group, tag, or prompt. If an object

Set up a standing search the user wants watched — 'track LinkedIn posts that mention hubspot', 'track tweets mentioning @dharmesh', 'watch acme.com/pricing for changes'. query is w

Delete an object from the user's graph. Use only when the user explicitly asks to delete or remove a specific object — never to tidy up on your own initiative. The delete is soft:

Delete EVERY object of one type from the user's graph, however many there are: what to reach for when they ask to clear out a whole category ('delete all my HubSpot contacts') rath

Delete a given list of objects from the user's graph, up to 200 object_ids in one call. Use only when the user explicitly asked for these particular objects to go, never to tidy up

Delete one connection between two objects in the user's graph — the edge from_object_id -> to_object_id of the given connection_type, nothing else; both objects stay. Use get_graph

Disconnect one connected account. Destructive and not undoable: disconnecting a HubSpot portal also deletes every record it synced. Never call this to check anything; call list_int

In the YouSpot chat only: draft a standing errand the user asked for, so they can turn it on with one tap. Use this whenever they ask for something to happen on its own from now on

Put a generated email (an artifact_id from generate_email) in the user's Gmail drafts, addressed to the recipients they named. Nothing is sent. The email has to be unlocked first:

Write every post in this week's post plan as a draft, in the user's own voice, saved to their brain as a note per post and linked to the plan. Posts that already have a draft are l

Read a public website and save its brand (colors, fonts, radius and logo) as a new brand kit that needs the user's review. Costs 3 credits, charged only when the kit is saved. Take

Search for companies by describing them in plain English — the same engine behind the ProspectFinder app. Handles industry, size, location, funding stage and investors in one query

Look through the connected mailboxes for newsletters and list the publications sending them, with how many arrived and how many the owner opened. Reads no bodies and changes nothin

How two objects in the user's graph are connected: the shortest chain of real relationships between them, up to 3 hops, e.g. person -[worked_with]- person -[works_at]- company. Onl

Render one branded email in a brand kit and save it to the user's files: any email the user describes, from a cold intro or a follow-up to a newsletter, an invitation, a launch not

Generate a photo for 1 credit to go behind a social image, from a description of the scene. Only when the user asks for a photo, picture or background. Describe the scene, the ligh

Write one document in the user's brand and save it to their files: anything they want to read in chat rather than print or send, from a to-do list or a checklist to a plan, notes,

Render one branded image in a brand kit for 1 credit and save it to the user's files: a link preview card, a social post, a story, a cover photo, a profile banner or a thumbnail. D

Render one branded PDF in a brand kit and save it to the user's files: any document the user describes, from an invoice or a statement to a one-pager, a proposal, a memo, a case st

Draft one Substack post and save it to the user's files, ready to paste into their Substack editor. Nothing is published and nothing is sent. Drafts are limited to 20 per day. Temp

Save a view the user wants to keep: a page in the view language that renders with live data, like a dashboard, a Markdown document, a feed of posts or a page of generated emails an

Read one generated image, email or PDF by artifact_id: its template, brand, status and, for the user's own drafts, the inputs it was made from, so an edit can call the generator ag

Read one brand kit with its colors, fonts, radius and domain, whether it is the space default and whether it still needs the user's review. Returns the logo, extraction source_url

List events from the user's connected calendars, Google and Outlook together, ordered by start time: summary, start/end, location, organizer, attendees and their RSVP status, a mee

Get the full profile for one of the user's LinkedIn connections: work history, education, skills, and their About summary. Use this after search_connections when you need depth on

Overview of the user's imported LinkedIn data: how many connections, invitations and messages they have, when it was last imported, and the companies they know the most people at.

Look up the public registration (WHOIS) record for a website domain: who registered it, which registrar holds it, when it was created and last updated, when it expires, its nameser

The search keywords a website is buying ads on (paid, PPC, AdWords, Google Ads) and the ones it ranks for organically, with monthly search volume, cost per click, position, landing

Estimate what a domain name is worth (the /domainvalue appraisal): an estimated market value in dollars with the signals behind it — comparable sales, marketplace listings, an appr

Fetch one Gmail message by its id from the user's connected mailbox, including the full plain-text body (rare header-only connections get headers and the snippet instead). Use this

One Granola meeting in full: the summary Granola wrote (Markdown), who attended, when, the space, a link to Granola, and the start of the transcript. `note` is an object id from ge

The user's Granola meeting notes already synced into their brain, newest first: title, when the meeting was, who attended, the space, and a link. `days` bounds how far back (defaul

Whether Granola is connected and how the sync is doing: the account, the shared spaces the key can see, when it last synced, and how many notes are in the brain. Use it when a user

Get one object from the user's graph, with the objects connected to it (its edges, e.g. a person's spaces, a note's subject). Identify it by object_id (exact, preferred — search an

Overview of the user's synced HubSpot data: which portals they have connected, how many contacts and companies came from each, and when each was last synced. Use this for questions

The URL that starts connecting one integration, for surfaces that cannot render a card (Slack, SMS, email). In chat, show the integrations_list card instead. Never claim to have co

Read the user's LinkedIn message history (DMs) with one person, from their imported LinkedIn export: every conversation that person is in, oldest first, with who sent each message

Overview of the user's imported LinkedIn messages (DMs): how many messages and conversations they have, the date range covered, and how many they sent versus received. Use for 'how

The posts the user bookmarked on X (Twitter), newest first — author @handle, text, date, engagement, and link, plus an author_counts rollup of how often each author appears across

The user's own LinkedIn posts with engagement numbers (reactions, likes, comments, shares): newest first by default, their earliest with sort='oldest', or their best-performing wit

The user's current YouSpot plan and credit balance, plus which plan they could move to. Call it before answering anything about pricing, plans, upgrading, credits or limits (brain

The user's own tweets, newest first, from their connected X (Twitter) accounts — text, engagement metrics (likes, replies, retweets, impressions), date, and link. Reads the synced

Read one note from the user's Obsidian vault in full: its markdown, frontmatter, tags, the notes and brain objects its wikilinks point at, and the notes that link back to it. Ident

The saved messages of one Slack thread, oldest first: the parent and every reply the brain holds. Only threads from channels the user switched on are stored; an empty result means

Accounts the user follows on X (Twitter), from the synced follow graph — name, @handle, and bio. `query` filters by name, handle, or bio text ('who do I follow in AI?'). Reads the

Live profile stats for the user's connected X (Twitter) accounts — name, @handle, follower count, following count, and total tweets, fresh from the X API. If it reports no account

Import every contact or company from a file the user uploaded — a CSV or spreadsheet export, a .vcf of contacts, or a zip. Use this whenever they want more than a couple of records

People in the user's network who have moved to a different company since we last looked, newest first, with where they were and where they are now. Use when they ask who has change

The user's LinkedIn post analytics from LinkedIn's own API (their connected account) — impressions, unique members reached, reactions, comments, and reshares. Use for questions lik

The user's own LinkedIn follower count over time, from readings we record about twice a day. Use it for every follower question: 'how many followers do I have?', 'how many did I ga

List the images, emails, PDFs and documents generated in the user's active space, newest first, up to 50: the artifact_id, kind, title, status and brand. kind narrows it to one kin

List the brand kits in the user's active space: the name, domain, primary color, whether it was extracted from a website or entered by hand, whether it still needs their review, an

List the labels in the user's connected Gmail mailboxes: system labels (INBOX, STARRED, ...) and the user's own labels, with their ids. Use it when the user refers to one of their

List the calendars in the user's connected Google account(s): name, id, whether it's the primary, and the user's access role. Use it to find a named calendar ('Family', 'Content sc

List objects in the user's graph, newest first, with counts by type. The graph is their personal CRM's object store: person, company, hubspot_contact, linkedin_connection, file, fa

What the user has connected, and what they could connect. Returns every integration available to this account with `connected` true/false, the accounts behind it, the tools it unlo

Browse the user's synced Obsidian notes without a search term — most recently changed first, optionally within one vault, one folder, or one tag. Use it to answer what a folder hol

List the Obsidian vaults the user has synced into their Second Brain: note counts, the folders each vault holds, its most-used tags, and when it last synced. Call this before answe

List the texts scheduled to be sent to the user's own phone that have not gone out yet, with the task_id needed to cancel each one.

The Slack channels and DMs the user's brain knows about, per connected workspace, with whether each one is being saved (ingest) and how many messages are stored. Use it to resolve

List the templates the user has saved from earlier drafts, newest first: the saved_template_id, name, kind and which manifest template it was made from. kind narrows it to one kind

Given the author names from a page of posts, say which of them this user already knows. Ask in one call with every name, not one at a time. Each answer carries `standing`: 'dormant

Merge two duplicate records in the user's graph into one, person or company only. Every connection moves from the duplicate onto the kept record, fields the kept record lacks are c

The objects in the user's graph directly connected to BOTH of two given objects — mutual contacts between two people, shared people between two companies. Only deliberate relations

How this week is going on LinkedIn against the user's own post plan: the plan's subjects and whether each has a draft, what they posted this week and which plan subject each post w

Work out what this user can speak to with authority, from what they have published, who is in their network, what they have been reading, and their profile — in that order of weigh

Read an invoice PDF the user uploaded and return its fields: supplier, invoice number, dates, currency, subtotal, tax, total, PO number, payment terms, and every line item. Use it

Work out what generating would use, rendering nothing and spending no draft or credit. Give it the kind (og_image for any image, email or pdf for any document) and whatever the use

Permanently delete one object from the user's graph, along with every connection touching it. Hard delete, no undo — confirm with the user before calling, and only when they asked

Read back objects a skill wrote earlier, filtered precisely. Use this when you need to know whether something is already recorded rather than to find something by name: has this en

People the user has not written to in a while, quietest first, with the date of the last thing they sent. Use when a skill needs to know who has gone quiet rather than to rank who

Return a generated item itself, for showing it where a YouSpot link cannot be opened: a social image comes back as the PNG, a PDF as an image of each page, an email, document or Su

Read the content of a file the user uploaded, use this when the answer may live in a document in their Second Brain: schedules, itineraries, contracts, exports, scans. PDFs and ima

Read every new issue from the allowed publications into the brain, whole, so they can answer questions later. Returns what landed: `created` is new issues, `updated` is ones whose

Fetch and read the content of one public web page by URL — use when the user asks what a page or article says, or you need to read a prospect's or company's own site before a conve

Record one dated touchpoint with someone in the user's graph — an email exchanged, a call, a meeting, a LinkedIn touch, or a manually noted contact — so 'when did I last talk to th

Who introduced the people in the user's graph, aggregated per introducer, so a skill can see which relationships actually produce work rather than which are warm. Returns each intr

Research one specific company in depth — the same engine behind the CompanyResearch.ai app. Takes a website domain (preferred) or a company name, and returns a profile: description

Bring back objects the user deleted, up to 200 object_ids in one call: the undo for delete_graph_object and delete_selected_graph_objects. Only the user's own deleted objects come

Save a generated image, email or PDF as a template in the user's Second Brain, so the same inputs can be generated again from the generator or from chat. Takes the artifact_id a ge

Download a file from a public http(s) URL and store it in the user's Second Brain as a file object — use when the user shares a direct link to a PDF, image, spreadsheet, or other f

Search the user's own LinkedIn connections by name, company, or job title. Use this to answer questions like 'who do I know at Stripe?', 'which of my connections are founders?', or

Search the user's connected Gmail mailboxes and return matching messages, newest first: from, to, subject, date, and a short snippet of the body. `query` uses Gmail search syntax:

Find where something was said across the user's Granola meetings: a phrase, a name, a product, a number. Searches summaries and full transcripts of synced notes and returns each ma

Search the user's graph by matching a term against object names and descriptions — plus semantic matching over text-bearing objects (notes, facts, posts, links, files, emails), so

Look up a person or company in the user's connected HubSpot CRM, live, by email address, domain, or name. Use this for 'what do I have on [email protected]', 'is gusto.com in the C

Search the text of the user's imported LinkedIn messages (DMs), newest first. Filter by words in the message, by the person it was with, and by date. Use for 'who messaged me about

Search public LinkedIn posts by keywords. In chat, and for a watcher agent that collects posts, the matches are stored in the user's brain automatically, so do not re-save them wit

Search the notes synced from the user's Obsidian vault, by keyword and by meaning, and get back where each one lives in the vault with an excerpt around the match. Use this when th

Search the Slack messages saved to the user's brain — by keyword and by meaning — newest first. Covers channels the user switched on and their DMs with YouSpot; nothing outside tho

Search recent public posts on X (Twitter) by keywords — the X API covers roughly the last week. Uses the user's connected X account; if none is connected, give the user the link it

Send an email to the signed-in user at their own account email address. Use this when the user asks to be sent something — 'email me this', 'send myself a reminder', 'send me that

Post a message to a Slack channel or DM as YouSpot, optionally as a reply in a thread. Only channels the bot has been invited to work; use list_slack_channels to find ids. Write it

Send a short text message (iMessage/SMS) to the user's own phone, the number they verified on the iMessage or SMS integration. Sends right now by default; pass send_at to schedule

Make a brand kit the default for the user's active space, so social images, emails and PDFs render in it when no brand_kit_id is given.

Set a dated follow-up about an object in the user's graph — 'follow up with Jane in March'. Creates a follow-up fact carrying follow_up_at (ISO 8601, usually in the future) and an

Rename or re-describe an object in the user's graph, or set any of its type-specific fields: a contact's phone, email, headline or location, a company's funding stage, and so on. '

Turn the user's LinkedIn manager on, pause it, or say what it is set to. On, it runs daily: plans the week from their recent work when there is no plan, drafts the posts in it, che

Turn the recurring emails YouSpot itself sends the user off or back on, when they ask to stop getting one, unsubscribe, or resume it. The emails: exec_briefings is the daily 'Daily

Put a generated item behind a public link, so it can be posted, embedded in a page or opened by someone with no YouSpot account. Anyone holding the link can see it. revoke true tak

The objects in the user's graph closest in MEANING to one object — nearest neighbours by stored embedding, so it finds related notes, facts, links, files, and posts even when no wo

Pull the user's newest Granola notes into their brain right away instead of waiting for the six-hourly sync. Queues the sync and returns; notes appear over the next minute or two.

The people the user has exchanged the most LinkedIn messages with, most-messaged first, with how many messages and when they last spoke. Use for 'who have I exchanged the most mess

Undo a merge_graph_objects call: the record that was folded in comes back, its connections move off the kept record, the duplicate edges that were dropped are recreated, and the fi

Change fields on a brand kit; fields left out keep their value. Set review_state 'confirmed' only after the user has looked at an imported kit and approved it. Returns the updated

Update one event on the user's connected Google or Outlook calendar: change its title (summary), description, location, or start/end times. Only the fields you pass change; everyth

Update the user's own profile fields when they ask: timezone, name, headline, company website, LinkedIn URL or X handle. Only pass the fields they asked to change. timezone must be

Save facts the user tells you about themselves into their profile fields (birthday, city, role, company stage and the like). `values` maps field_id to the new value; an empty strin

Change a saved view in place: new source, title, spec_version or state. Pass only what changes. The artifact_id, its brain object and any share link stay the same.

Every component and builtin a view can use (layout, charts, tables, Markdown, post cards, images and live cards), with its arguments, how Query, Mutation and Action work, the edit

Search the open web and get back titles, URLs and snippets. Use when the answer is not in the user's own data and not about one named company: what a competitor is saying publicly,

What this user should deal with right now, computed from their sent mail, their calendar, their LinkedIn export and the follow-ups they set: follow-ups due this week or overdue, pe