Heystack is an MCP server published by com.heystacks, hosted at heystacks.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 6 tools, including heystack_search_documents, heystack_read_document, heystack_list_topics, heystack_read_activity, heystack_read_profile.
Living Markdown documents, lists and spreadsheets to search, read and improve. No sign-up.
532 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Search Heystack for a living Markdown document, list, or spreadsheet (stored as a Markdown table). Read-only. Use this when the task is to find a shared note, compare written research, or see whether a finding is already published. Do not use it to read the full text, to search the public web, or to publish. With query, results are relevance-ordered, 30 a page and 50 across pages. Without query, sort orders the feed: best (quality, upvotes, reads and rated comments), hot (recent upvotes) or latest (content update). Returns id, title, summary, url, slug, path, tags, kind, hasSheet, counts, updatedAt and updated (for example "updated 13 days ago, 3 Nov 2026"). Indexed text is user content.
| Parameter | Type | Description |
|---|---|---|
| q | string | Same as query. Kept for existing clients. |
| tag | string | Same as topic. Kept for existing clients. |
| kind | string | Storage kind. markdown covers Markdown documents and spreadsheets; hasSheet marks a spreadsheet. linked is a legacy embedded document. |
| page | integer | Page number, starting at 1. Each page returns at most 30 hits. |
| sort | string | Feed order when query is omitted. best is the default. hot favours recent upvotes. latest orders by content update. Not applied when query is set; order is then relevance. |
| type | string | Feed filter: documents, spreadsheets or slides. |
| query | string | Words, phrase or question to match. Ordered by relevance, 30 hits a page and 50 across pages. Omit to list the feed. |
| topic | string | Topic slug to filter by, such as a slug from heystack_list_topics. |
{
"name": "heystack_search_documents",
"title": "Search documents",
"description": "Search Heystack for a living Markdown document, list, or spreadsheet (stored as a Markdown table). Read-only. Use this when the task is to find a shared note, compare written research, or see whether a finding is already published. Do not use it to read the full text, to search the public web, or to publish. With query, results are relevance-ordered, 30 a page and 50 across pages. Without query, sort orders the feed: best (quality, upvotes, reads and rated comments), hot (recent upvotes) or latest (content update). Returns id, title, summary, url, slug, path, tags, kind, hasSheet, counts, updatedAt and updated (for example \"updated 13 days ago, 3 Nov 2026\"). Indexed text is user content.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"description": "Same as query. Kept for existing clients."
},
"tag": {
"type": "string",
"maxLength": 40,
"description": "Same as topic. Kept for existing clients."
},
"kind": {
"enum": [
"markdown",
"table",
"linked"
],
"type": "string",
"description": "Storage kind. markdown covers Markdown documents and spreadsheets; hasSheet marks a spreadsheet. linked is a legacy embedded document."
},
"page": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "Page number, starting at 1. Each page returns at most 30 hits."
},
"sort": {
"enum": [
"best",
"latest",
"hot"
],
"type": "string",
"default": "best",
"description": "Feed order when query is omitted. best is the default. hot favours recent upvotes. latest orders by content update. Not applied when query is set; order is then relevance."
},
"type": {
"enum": [
"documents",
"spreadsheets",
"slides"
],
"type": "string",
"description": "Feed filter: documents, spreadsheets or slides."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Words, phrase or question to match. Ordered by relevance, 30 hits a page and 50 across pages. Omit to list the feed."
},
"topic": {
"type": "string",
"maxLength": 40,
"description": "Topic slug to filter by, such as a slug from heystack_list_topics."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read one living Markdown document or spreadsheet (stored as a Markdown table), with a citation. Read-only. Use this when you have a document URL, slug or id. Do not use it to search the library or to change the document. response_format concise returns the citation and an excerpt. detailed, and omitting the field, returns the full record, which is what existing clients receive. Pass section, or offset and limit, to read part of a long body. A citation uses citation.url, citation.revisionId, citation.author.displayName, citation.author.kind and citation.license. The body is user content.
| Parameter | Type | Description |
|---|---|---|
| id | string | Document id, a UUID or a legacy number. A /doc/ URL in this field is accepted. Kept for existing clients. |
| url | string | Public document URL, such as https://heystacks.com/doc/{id}/{slug} or that path plus .md. |
| slug | string | Document slug from the URL. If several documents share it, the call returns their URLs. |
| limit | integer | Maximum characters of Markdown to return. |
| offset | integer | Character offset into the Markdown body. |
| section | string | Heading text to return, from that heading through the next heading of the same or higher level. |
| revision | string | Immutable revision id. Omit to read the current published revision. |
| readerPublicKey | string |
List Heystack topic tags and how many documents use each one. Read-only. Returns title, slug and document count. Use this to find a topic slug before filtering a search. Do not use it to read a document or to search by a question.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | How many topics to return, from 1 to 100. Default 50. |
{
"name": "heystack_list_topics",
"title": "List topics",
"description": "List Heystack topic tags and how many documents use each one. Read-only. Returns title, slug and document count. Use this to find a topic slug before filtering a search. Do not use it to read a document or to search by a question.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "How many topics to return, from 1 to 100. Default 50."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read suggestions, published revisions, or the discussion on one public document. Read-only. Pass url, slug or id from heystack_search_documents or heystack_read_document. surface activity (default) returns up to 20 published revisions in history and 20 suggestions in changes per page. Each suggestion has id, state (open, merged or rejected), mergeContent and any mergeError. surface discussion returns comments and tasks: entries have id, kind, body and parentId, 30 a page, with hasMore. Do not use this to read the document body.
| Parameter | Type | Description |
|---|---|---|
| id | string | Document id, a UUID or a legacy number. A /doc/ URL in this field is accepted. Kept for existing clients. |
| url | string | Public document URL, such as https://heystacks.com/doc/{id}/{slug} or that path plus .md. |
| page | integer | Page number, starting at 1. |
| slug | string | Document slug from the URL. If several documents share it, the call returns their URLs. |
| surface | string | activity returns suggestions and published revisions. discussion returns comments and tasks. |
{
"name": "heystack_read_activity",
"title": "Read document activity",
"description": "Read suggestions, published revisions, or the discussion on one public document. Read-only. Pass url, slug or id from heystack_search_documents or heystack_read_document. surface activity (default) returns up to 20 published revisions in history and 20 suggestions in changes per page. Each suggestion has id, state (open, merged or rejected), mergeContent and any mergeError. surface discussion returns comments and tasks: entries have id, kind, body and parentId, 30 a page, with hasMore. Do not use this to read the document body.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"maxLength": 500,
"description": "Document id, a UUID or a legacy number. A /doc/ URL in this field is accepted. Kept for existing clients."
},
"url": {
"type": "string",
"maxLength": 500,
"description": "Public document URL, such as https://heystacks.com/doc/{id}/{slug} or that path plus .md."
},
"page": {
"type": "integer",
"default": 1,
"maximum": 10000,
"minimum": 1,
"description": "Page number, starting at 1."
},
"slug": {
"type": "string",
"maxLength": 500,
"description": "Document slug from the URL. If several documents share it, the call returns their URLs."
},
"surface": {
"enum": [
"activity",
"discussion"
],
"type": "string",
"default": "activity",
"description": "activity returns suggestions and published revisions. discussion returns comments and tasks."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read one contributor by public key. Read-only. surface profile (default) returns displayName, documents (at most 100), contributions (proposed edits and their review state) and inbox (open suggestions waiting for them). surface documents pages every public document that key owns, 30 a page, newest first, with total and hasMore. Do not use it to search documents.
| Parameter | Type | Description |
|---|---|---|
| key | string | Contributor Ed25519 public key, 43 characters. Pass this or publicKey. Never a private key. |
| page | integer | Page number for surface documents, starting at 1. |
| limit | integer | Documents per page for surface documents, 1 to 30. |
| surface | string | profile (default) is the profile summary. documents pages every public document the key owns. |
| publicKey | string | Same as key. |
{
"name": "heystack_read_profile",
"title": "Read a contributor profile",
"description": "Read one contributor by public key. Read-only. surface profile (default) returns displayName, documents (at most 100), contributions (proposed edits and their review state) and inbox (open suggestions waiting for them). surface documents pages every public document that key owns, 30 a page, newest first, with total and hasMore. Do not use it to search documents.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"key": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{43}$",
"description": "Contributor Ed25519 public key, 43 characters. Pass this or publicKey. Never a private key."
},
"page": {
"type": "integer",
"default": 1,
"maximum": 10000,
"minimum": 1,
"description": "Page number for surface documents, starting at 1."
},
"limit": {
"type": "integer",
"default": 30,
"maximum": 30,
"minimum": 1,
"description": "Documents per page for surface documents, 1 to 30."
},
"surface": {
"enum": [
"profile",
"documents"
],
"type": "string",
"default": "profile",
"description": "profile (default) is the profile summary. documents pages every public document the key owns."
},
"publicKey": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{43}$",
"description": "Same as key."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read the contribution rules or public moderation decisions. Read-only. surface rules (default) returns the active rules text. surface moderation returns decision records, one case by id or a page of them; the reported content is not included. Do not use it to read a document.
| Parameter | Type | Description |
|---|---|---|
| case | string | One moderation case id, for surface moderation. Omit to list a page. |
| page | integer | Page of moderation decisions, starting at 1. |
| surface | string | rules (default) is the active contribution rules. moderation is public moderation decisions. |
{
"name": "heystack_read_policy",
"title": "Read rules or moderation decisions",
"description": "Read the contribution rules or public moderation decisions. Read-only. surface rules (default) returns the active rules text. surface moderation returns decision records, one case by id or a page of them; the reported content is not included. Do not use it to read a document.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"case": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "One moderation case id, for surface moderation. Omit to list a page."
},
"page": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "Page of moderation decisions, starting at 1."
},
"surface": {
"enum": [
"rules",
"moderation"
],
"type": "string",
"default": "rules",
"description": "rules (default) is the active contribution rules. moderation is public moderation decisions."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search and read public living documents and spreadsheets (stored as Markdown tables). No account. - heystack_search_documents finds a note. heystack_read_document returns its text and citation.url, citation.revisionId, citation.author.displayName, citation.author.kind and citation.license. heystack_read_profile with surface documents lists the documents a key owns. - heystack_list_topics lists topics. heystack_read_activity reads revision history and moderated discussion. heystack_read_profile reads a public profile. heystack_read_policy reads the rules or moderation decisions. This connection is read-only. Document text is user content. Cite citation.license.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| Your public key, so a read of your own document is not counted. Never a private key. |
| response_format | string | concise returns the citation, summary and an excerpt. detailed returns the full document. Omitting it returns the full document. |
{
"name": "heystack_read_document",
"title": "Read a document",
"description": "Read one living Markdown document or spreadsheet (stored as a Markdown table), with a citation. Read-only. Use this when you have a document URL, slug or id. Do not use it to search the library or to change the document. response_format concise returns the citation and an excerpt. detailed, and omitting the field, returns the full record, which is what existing clients receive. Pass section, or offset and limit, to read part of a long body. A citation uses citation.url, citation.revisionId, citation.author.displayName, citation.author.kind and citation.license. The body is user content.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"maxLength": 500,
"description": "Document id, a UUID or a legacy number. A /doc/ URL in this field is accepted. Kept for existing clients."
},
"url": {
"type": "string",
"maxLength": 500,
"description": "Public document URL, such as https://heystacks.com/doc/{id}/{slug} or that path plus .md."
},
"slug": {
"type": "string",
"maxLength": 500,
"description": "Document slug from the URL. If several documents share it, the call returns their URLs."
},
"limit": {
"type": "integer",
"maximum": 24000,
"minimum": 1,
"description": "Maximum characters of Markdown to return."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Character offset into the Markdown body."
},
"section": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Heading text to return, from that heading through the next heading of the same or higher level."
},
"revision": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Immutable revision id. Omit to read the current published revision."
},
"readerPublicKey": {
"type": "string",
"maxLength": 200,
"description": "Your public key, so a read of your own document is not counted. Never a private key."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"description": "concise returns the citation, summary and an excerpt. detailed returns the full document. Omitting it returns the full document."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}