Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 10 additions & 2 deletions src/components/Header.astro
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ const { title } = Astro.props;
{title === SITE_TITLE && PORTRAIT ? <Portrait {...PORTRAIT} /> : <a href='/'>{title}</a>}
</h1>
) : (
<a href='/'>↩ Index</a>
<a class='back' href='/'><span aria-hidden='true'>↩</span>Index</a>
)}
</header>

Expand All @@ -25,7 +25,6 @@ const { title } = Astro.props;
}

a {
text-decoration: none;
color: var(--theme-sub-text);

&:hover {
Expand All @@ -36,4 +35,13 @@ const { title } = Astro.props;
color: var(--theme-bg);
}
}

h1 a {
text-decoration: none;
}

.back span {
display: inline-block;
margin-inline-end: 1ch;
}
</style>
36 changes: 27 additions & 9 deletions src/components/NoteNav.astro
Original file line number Diff line number Diff line change
Expand Up @@ -12,22 +12,20 @@ const { prev, next } = Astro.props;
<nav>
{prev && (
<a class='prev' href={`/notes/${prev.id}/`} rel='prev'>
<span aria-hidden='true'>←</span>
{prev.data.title}
<span aria-hidden='true'>←</span>{prev.data.title}
</a>
)}
{next && (
<a class='next' href={`/notes/${next.id}/`} rel='next'>
{next.data.title}
<span aria-hidden='true'>→</span>
{next.data.title}<span aria-hidden='true'>→</span>
</a>
)}
</nav>

<style>
nav {
display: grid;
grid-template-columns: 1fr 1fr;
grid-template-columns: repeat(2, minmax(0, 1fr));
column-gap: 2ch;

margin-top: 3em;
Expand All @@ -36,11 +34,13 @@ const { prev, next } = Astro.props;
}

a {
display: flex;
gap: 1ch;
position: relative;
max-width: 100%;
overflow: hidden;

text-decoration: none;
color: var(--theme-sub-text);
white-space: nowrap;
text-overflow: ellipsis;

&:hover {
color: var(--theme-text);
Expand All @@ -51,13 +51,31 @@ const { prev, next } = Astro.props;
}
}

span {
position: absolute;
inset-block-start: 0;
}

.prev {
justify-self: start;
padding-inline-start: 2ch;

span {
inset-inline-start: 0;
}
}

.next {
grid-column: 2;
justify-self: end;
text-align: end;
padding-inline-end: 2ch;

span {
inset-inline-end: 0;
}
}

a:only-child {
grid-column: 1 / -1;
}
</style>
65 changes: 65 additions & 0 deletions src/content/notes/rss-to-mcp.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
title: RSS → MCP
pubDate: 2026-11-14T10:00:00Z
description: How the two standards can work together
slug: rss-to-mcp
published: true
---

RSS answers one question: what's new? Agents ask other questions, so they scrape your pages and retell your work in their own words.

What if every personal site had its own MCP? Instead of just scraping HTML, an agent could ask the site directly and get back what the author actually wrote. RSS pushes what I published. MCP lets you ask about it.

### The page

[WebMCP](https://github.com/webmachinelearning/webmcp) is an early proposal for this. A page registers its own tools, and the agent calls them instead of guessing from the DOM.

```js
await document.modelContext.registerTool({
name: "about",
description: "Who I am and what this site is",
execute() {
return "Vlad's notes on engineering and life";
}
});

await document.modelContext.registerTool({
name: "ask",
description: "Ask a question, answered from my notes",
inputSchema: {
type: "object",
properties: { question: { type: "string" } },
required: ["question"]
},
execute({ question }) {
return answerFromNotes(question);
}
});

await document.modelContext.registerTool({
name: "subscribe",
description: "Get new notes as they come out",
execute() {
// RSS feed, email newsletter, push notifications, etc.
return "[https://esafev.com/rss.xml](https://esafev.com/rss.xml)";
}
});
```

### The feed

RSS and MCP can point to each other. The `subscribe` tool returns my RSS feed, and the feed itself can list my MCP tools. RSS is already extensible through XML namespaces (that's how podcast feeds added chapters and transcripts).

```xml
<channel xmlns:mcp="[https://esafev.com/ns/mcp](https://esafev.com/ns/mcp)">
<title>Vlad Esafev</title>
<mcp:tool name="about">Who I am and what this site is</mcp:tool>
<mcp:tool name="ask">Ask a question, answered from my notes</mcp:tool>
</channel>
```

### The standard

RSS worked because every feed had the same structure, so one reader could follow any site. Agents don't strictly need that, since they can figure out any tool from its description. But feed readers do. If `ask` meant the same thing everywhere, your reader could add an "Ask" box to every blog you follow.

The [IndieWeb](https://indieweb.org/) already agreed on Webmention and microformats. Could we agree on a few standard tools, too?
19 changes: 13 additions & 6 deletions src/layouts/NoteLayout.astro
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,10 @@ const {
margin-block: 1em;
}

:global(h2, h3) {
margin-block-start: 2em;
}

:global(h2) {
font-size: 1.3em;
}
Expand Down Expand Up @@ -70,23 +74,26 @@ const {
:global(code) {
padding: 0.2rem 0.33rem;
margin-inline: -0.125em;
border-radius: 3px;

font-family: inherit;
font-size: 0.85em;
overflow-wrap: anywhere;

background-color: var(--theme-code-block);
}

:global(pre) {
--padding-inline: 2rem;
padding: 1rem var(--padding-inline);
--padding-inline: 1.25rem;
margin-block: 1.5em;
padding: 1.25rem var(--padding-inline);
padding-inline-end: calc(var(--padding-inline) * 2);
overflow: auto hidden;

@media (width >= 37.75em) {
--padding-inline: 1.25rem;
border-radius: 8px;
font-family: inherit;

@media (width <= 480px) {
--padding-inline: 1em;
padding-block: 1em;
}
}

Expand Down
7 changes: 6 additions & 1 deletion src/styles/global.css
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,11 @@
background-color: light-dark(var(--color-sky-medium), var(--color-klein-light));
}

code::selection,
code ::selection {
background-color: var(--theme-bg);
}

* {
box-sizing: border-box;
margin: 0;
Expand All @@ -67,7 +72,7 @@ body {
@media (width <= 480px) {
body {
max-width: 100%;
padding: 1em;
padding: 3em 1em 1em;
}
}

Expand Down