Skip to content

feat: allow markdown files titles for mcp resources#35

Merged
disintegrator merged 4 commits intomainfrom
mcp-resource-titles
Mar 4, 2026
Merged

feat: allow markdown files titles for mcp resources#35
disintegrator merged 4 commits intomainfrom
mcp-resource-titles

Conversation

@disintegrator
Copy link
Contributor

@disintegrator disintegrator commented Mar 4, 2026

This change extracts human-readable titles for MCP resources from markdown files. Titles are resolved using frontmatter title with a fallback to the first H1 heading. These titles appear in MCP resource listings, making it easier for agents to identify documents.

Codex

CleanShot 2026-03-04 at 16 09 03@2x

Claude Code

CleanShot 2026-03-04 at 16 18 27@2x

VS Code

CleanShot 2026-03-04 at 15 34 21@2x

Claude Desktop

CleanShot 2026-03-04 at 15 33 41@2x

This change adds support for document titles in markdown frontmatter.
When this field is present, it is also reflected in the corresponding
MCP resource for a markdown file.
@disintegrator disintegrator requested a review from a team March 4, 2026 16:18
@changeset-bot
Copy link

changeset-bot bot commented Mar 4, 2026

🦋 Changeset detected

Latest commit: 0390bbe

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 5 packages
Name Type
@speakeasy-api/docs-mcp-server Minor
@speakeasy-api/docs-mcp-core Minor
@speakeasy-api/docs-mcp-cli Minor
@speakeasy-api/docs-mcp-eval Minor
@speakeasy-api/docs-mcp-playground Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@disintegrator disintegrator changed the title feat: allow markdown files to set titles in frontmatter feat: allow markdown files titles for mcp resources Mar 4, 2026
@disintegrator disintegrator merged commit 8a321c5 into main Mar 4, 2026
1 check passed
@disintegrator disintegrator deleted the mcp-resource-titles branch March 4, 2026 17:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants