MCP Server

hovhannes.io

io.hovhannes/site
Communication Knowledge & Documentation Public & reachable MCP 2025-11-25

What this MCP does

Searches and retrieves product-related field notes and provides information about Yerevan Product Coffee tables and seat requests.

get_field_note
Read one field note in full
The complete text of a single field note. Use this after search_field_notes or list_field_notes, which return only an excerpt. Accepts the slug, the path, or the full URL — 'what-30-days-of-crawler-logs-showed', '/what-30-days-of-crawler-logs-showed' and 'https://hovhannes.io/what-30-days-of-crawler-logs-showed' all work.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['note'], 'properties': {'note': {'type': 'string', 'maxLength': 300, 'minLength': 3, 'description': "The note's slug, path, or URL"}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['title', 'url', 'category', 'publishedAt', 'text'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string', 'description': 'The note in full, as plain text'}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'readTime': {'type': 'string'}, 'publishedAt': {'type': 'string'}}, 'additionalProperties': False}
get_sprint_details
Clarity Sprint details
What a Clarity Sprint is, what it produces, how long it takes, what it costs, and where to apply. Use this when asked how to work with Hovhannes or what he offers.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name', 'url', 'summary', 'duration', 'price', 'deliverable', 'guarantee', 'applyAt'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'price': {'type': 'string'}, 'applyAt': {'type': 'string'}, 'summary': {'type': 'string'}, 'duration': {'type': 'string'}, 'guarantee': {'type': 'string'}, 'deliverable': {'type': 'string'}}, 'additionalProperties': False}
list_field_notes
List every field note
Every published field note with its title, category and date, newest first. Use this to see the full range of what has been written before searching within it, then get_field_note to read one in full.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['count', 'notes'], 'properties': {'count': {'type': 'number'}, 'notes': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'url', 'category', 'publishedAt'], 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'readTime': {'type': 'string'}, 'publishedAt': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
list_upcoming_tables
Upcoming Yerevan Product Coffee tables
The scheduled dates for the private six-person product roundtable in Yerevan, with how many guest seats remain on each. Use this to answer when the next table is or whether a given date still has room, and to get the exact `startsAt` value that request_table_seat needs.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['tables'], 'properties': {'tables': {'type': 'array', 'items': {'type': 'object', 'required': ['startsAt', 'date', 'time', 'city', 'theme', 'guestSeatsTotal', 'seatsLeft', 'isFull', 'requestAt'], 'properties': {'city': {'type': 'string'}, 'date': {'type': 'string'}, 'time': {'type': 'string'}, 'theme': {'type': 'string'}, 'isFull': {'type': 'boolean'}, 'startsAt': {'type': 'string', 'description': 'The exact instant to pass back to request_table_seat'}, 'requestAt': {'type': 'string'}, 'seatsLeft': {'type': 'number'}, 'guestSeatsTotal': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
request_table_seat
Request a seat at a Yerevan Product Coffee table
Ask for one of the five guest seats at a Yerevan Product Coffee table. Call list_upcoming_tables first and pass one of its exact `startsAt` values. This sends a real request to a real person, so it takes two calls: call it once to see exactly what would be sent, show that to the person it is about, then call it again with the same values and confirm: true. A request is not a booking — Hovhannes reads each one himself and replies within 3–5 days, and no seat is held until he does.
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['fullName', 'email', 'phone', 'linkedinUrl', 'perspective', 'eventStart'], 'properties': {'email': {'type': 'string', 'maxLength': 254, 'minLength': 3, 'description': 'Their email address. The reply and the confirmation both go here, so it has to be one they read'}, 'phone': {'type': 'string', 'maxLength': 32, 'minLength': 5, 'description': 'Their phone number with its country code, like +374 11 22 33 44. Used only on the evening itself and deleted if the request is closed'}, 'confirm': {'type': 'boolean', 'description': 'Leave unset or false to validate and preview without sending anything. Set to true only after the person has seen the preview and agreed to it'}, 'building': {'type': 'string', 'maxLength': 1000, 'description': 'What they are building, in their own words. Optional but read'}, 'fullName': {'type': 'string', 'maxLength': 80, 'minLength': 2, 'description': "The applicant's full name, as they would write it"}, 'eventStart': {'type': 'string', 'maxLength': 40, 'minLength': 4, 'description': 'Which table. The exact `startsAt` from list_upcoming_tables is best, but the calendar day on its own ("2026-09-10") or the word "next" also resolve against the real schedule'}, 'motivation': {'type': 'string', 'maxLength': 600, 'description': 'Why this table, now. Optional'}, 'linkedinUrl': {'type': 'string', 'maxLength': 500, 'minLength': 5, 'description': 'Their personal LinkedIn profile URL (linkedin.com/in/â\x80¦). Required: seats are chosen on who sits together, which cannot be judged from a name. Company pages, posts and shortened links are refused'}, 'perspective': {'enum': ['founder', 'product', 'design-research', 'engineering', 'growth', 'customer', 'hybrid-other'], 'type': 'string', 'description': 'The perspective they bring: founder (Building or validating a product of your own.); product (Deciding scope, priority, discovery, and delivery.); design-research (Bringing users, flows, and evidence into the room.); engineering (Turning product intent into something real.); growth (Positioning, demand, distribution, retention.); customer (Sales, support, and discovery signals.); hybrid-other (More than one lens, and that is fine.)'}, 'contribution': {'type': 'string', 'maxLength': 600, 'description': 'What they can offer the other five people. Optional'}, 'discussionQuestion': {'type': 'string', 'maxLength': 600, 'description': "The one real decision or trade-off they are stuck on and want the table's help with. Optional, and the single most useful thing to include"}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['submitted'], 'properties': {'table': {'type': 'string'}, 'status': {'type': 'string'}, 'message': {'type': 'string'}, 'duplicate': {'type': 'boolean'}, 'submitted': {'type': 'boolean'}, 'dailyLimit': {'type': 'string'}, 'willSubmit': {'type': 'object', 'required': ['fullName', 'email', 'phone', 'linkedinUrl', 'perspective', 'table', 'theme', 'building', 'discussionQuestion', 'motivation', 'contribution', 'shownPubliclyAsAttendee'], 'properties': {'email': {'type': 'string'}, 'phone': {'type': 'string'}, 'table': {'type': 'string'}, 'theme': {'type': 'string'}, 'building': {'type': 'string'}, 'fullName': {'type': 'string'}, 'motivation': {'type': 'string'}, 'linkedinUrl': {'type': 'string'}, 'perspective': {'type': 'string'}, 'contribution': {'type': 'string'}, 'discussionQuestion': {'type': 'string'}, 'shownPubliclyAsAttendee': {'type': 'boolean'}}, 'additionalProperties': False}, 'instruction': {'type': 'string'}, 'privacyNote': {'type': 'string'}, 'alreadyRequested': {'type': 'boolean'}, 'needsConfirmation': {'type': 'boolean'}, 'whatHappensOnConfirm': {'type': 'array', 'items': {'type': 'string'}}, 'confirmationEmailedTo': {'type': 'string'}, 'confirmationEmailStatus': {'type': 'string'}}, 'additionalProperties': False}
search_field_notes
Search the field notes
Search Hovhannes Hovhannisyan's written field notes on product planning, MVP scope, and building with AI agents. Returns the closest notes with a short excerpt and a link. Use this when asked what he has written or thinks about a product topic, then get_field_note to read one in full.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 120, 'minLength': 2, 'description': 'What to look for, in words'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query', 'matchCount', 'notes'], 'properties': {'notes': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'url', 'category', 'publishedAt', 'excerpt'], 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}, 'excerpt': {'type': 'string'}, 'category': {'type': 'string'}, 'publishedAt': {'type': 'string'}}, 'additionalProperties': False}}, 'query': {'type': 'string'}, 'matchCount': {'type': 'number'}}, 'additionalProperties': False}
Added
get_field_note
Sept. 17, 2026, 12:53 p.m.
Added
request_table_seat
Sept. 17, 2026, 12:53 p.m.
Added
list_field_notes
Sept. 17, 2026, 12:53 p.m.
Added
get_sprint_details
Sept. 17, 2026, 12:53 p.m.
Added
search_field_notes
Sept. 17, 2026, 12:53 p.m.
Added
list_upcoming_tables
Sept. 17, 2026, 12:53 p.m.