add API routes for an external mcp server

Author: kentcdodds

app/routes/api+/blog-post.$slug.ts

@@ -0,0 +1,13 @@
+import { json } from '@remix-run/node'
+import { downloadMdxFilesCached } from '#app/utils/mdx.server.js'
+
+export async function loader({ params }: { params: { slug: string } }) {
+	const { slug } = params
+	const { files } = await downloadMdxFilesCached('blog', slug, {})
+
+	if (!files.length) {
+		throw new Response(`No blog post found with slug: ${slug}`, { status: 404 })
+	}
+
+	return json(files)
+}

app/routes/api+/chats-with-kent-episode.$seasonNumber.$episodeNumber.ts

@@ -0,0 +1,38 @@
+import { json } from '@remix-run/node'
+import { getSeasons } from '#app/utils/simplecast.server.js'
+
+export async function loader({
+	params,
+	request,
+}: {
+	params: { seasonNumber: string; episodeNumber: string }
+	request: Request
+}) {
+	const seasonNumber = Number(params.seasonNumber)
+	const episodeNumber = Number(params.episodeNumber)
+
+	if (isNaN(seasonNumber) || isNaN(episodeNumber)) {
+		throw new Response('Season and episode numbers must be valid numbers', {
+			status: 400,
+		})
+	}
+
+	const seasons = await getSeasons({ request })
+	const season = seasons.find((s) => s.seasonNumber === seasonNumber)
+
+	if (!season) {
+		throw new Response(`Season ${seasonNumber} not found`, { status: 404 })
+	}
+
+	const episode = season.episodes.find((e) => e.episodeNumber === episodeNumber)
+
+	if (!episode) {
+		throw new Response(`Episode ${episodeNumber} not found`, { status: 404 })
+	}
+
+	return json({
+		title: episode.title,
+		description: episode.description,
+		transcript: episode.transcriptHTML || null,
+	})
+}

app/routes/api+/find-content.ts

@@ -0,0 +1,41 @@
+import { json } from '@remix-run/node'
+import { getDomainUrl } from '#app/utils/misc.js'
+import { searchKCD } from '#app/utils/search.server.js'
+
+export async function loader({ request }: { request: Request }) {
+	const url = new URL(request.url)
+	const query = url.searchParams.get('query')
+	const category = url.searchParams.get('category')
+
+	if (!query) {
+		throw new Response('Query parameter is required', { status: 400 })
+	}
+
+	const categoryMap: Record<string, string> = {
+		Blog: 'b',
+		'Chats with Kent Podcast': 'cwk',
+		'Call Kent Podcast': 'ckp',
+		Workshops: 'w',
+		Talks: 't',
+	}
+
+	const searchResults = await searchKCD({
+		request,
+		query: category ? `${categoryMap[category]}:${query}` : query,
+	})
+
+	const domainUrl = getDomainUrl(request)
+
+	if (searchResults.length) {
+		return json(
+			searchResults.map(({ title, route, segment, metadata }) => ({
+				title,
+				url: `${domainUrl}${route}`,
+				category: segment,
+				...metadata,
+			})),
+		)
+	}
+
+	return json([])
+}

app/routes/api+/subscribe-to-newsletter.ts

@@ -0,0 +1,36 @@
+import { json } from '@remix-run/node'
+import { addSubscriberToForm } from '#app/kit/kit.server.js'
+import { getErrorMessage } from '#app/utils/misc.js'
+
+export async function action({ request }: { request: Request }) {
+	if (request.method !== 'POST') {
+		return new Response('Method not allowed', { status: 405 })
+	}
+
+	const formData = await request.formData()
+	const email = formData.get('email')?.toString()
+	const firstName = formData.get('firstName')?.toString()
+
+	if (!email) {
+		return json({ error: 'Email is required' }, { status: 400 })
+	}
+
+	try {
+		await addSubscriberToForm({
+			email,
+			firstName: firstName ?? '',
+			kitFormId: '827139',
+		})
+
+		return json({
+			message: `Successfully subscribed ${email} to Kent's newsletter! If you're not already on Kent's mailing list, you'll receive a confirmation email.`,
+		})
+	} catch (error) {
+		return json(
+			{
+				error: `Failed to subscribe to the newsletter: ${getErrorMessage(error)}`,
+			},
+			{ status: 500 },
+		)
+	}
+}