For developers

Add 404 Love Found to your website

Choose the integration that fits your stack and go live quickly with an adoptable, privacy-respecting 404 experience.

Search adoptable pets from your AI agent

We expose a Model Context Protocol (MCP) server so any MCP-capable agent can search adoptable pets and fetch full profiles, including organization contact details.

MCP

One-line install

Claude Code

claude mcp add --transport http 404found-love https://404found.love/api/mcp

Gemini CLI

gemini mcp add --transport http 404found-love https://404found.love/api/mcp

Codex CLI

codex mcp add 404found-love --url https://404found.love/api/mcp

VS Code

code --add-mcp '{"name":"404found-love","type":"http","url":"https://404found.love/api/mcp"}'

JSON config

{
  "mcpServers": {
    "404found-love": {
      "type": "http",
      "url": "https://404found.love/api/mcp"
    }
  }
}

For clients without a CLI (Cursor, Windsurf, opencode, and others), add the server URL https://404found.love/api/mcpto your client's MCP config.

Tools: search_adoptable_pets (filters by pet type, age, sex, size, coat, and more) and get_pet_profile (photos, description, and organization contact info).

Option 1: Next.js SDK

Best for Next.js App Router projects. Install the SDK and export a ready-to-go 404 page.

App Router

Install

npm install @404love/next

app/not-found.tsx

import { createNotFoundPage } from "@404love/next"

export default createNotFoundPage()

Optional: customize with back link labels, query params, and iframe styling using createNotFoundPage options. See theNext.js SDK README.

View the Next.js Demo

Option 2: Embedded iframe

Drop a full-page iframe into any stack. Add an optional referer query param to enable the built-in back link.

Universal

HTML embed

<iframe
  title="404 Love Found"
  src="https://404found.love/frame?referer=https://your-domain.com"
  style="width: 100%; min-height: 100vh; border: 0;"
  loading="lazy"
></iframe>

Add a referer query param to guarantee the back link works even when browsers suppress referrer headers. Replace your-domain.com with your URL.

View the Iframe Demo

Try our agent skill

Add the 404love skill to your agent toolkit for guided Next.js setup and troubleshooting.

Agent skill

npx

npx skills add https://github.com/dariorapisardi/404love --skill 404love-next

Uses the skills.sh CLI to install the 404love-next skill. See theskill README.