Developer & AI Agent Platform

Wishiva Developer Documentation

Build with Wishiva APIs, connect autonomous AI agents via Model Context Protocol (MCP), and query structured Markdown via acceptmarkdown.com standards.

OpenAPI Spec (JSON)LLMs.txt Directory MCP Server Manifest

Machine-Readable Endpoints & Standards

Standardized endpoints allowing crawlers, indexers, and LLMs to autonomously understand Wishiva.

LLMs.txt & Full Context

Structured Markdown documents designed for LLM ingestion, summarizing architecture, reveal styles, and endpoint URLs.

/llms.txt /llms-full.txt

OpenAPI 3.1.0 Specification

Full REST specification describing parameters, responses, and schemas for public Wishiva endpoints.

/api/openapi.json /.well-known/openapi.yaml

Model Context Protocol (MCP)

Standard tool calling manifest for Claude, OpenAI, and Gemini agents to search templates and query documentation.

/.well-known/mcp.json /api/mcp

Markdown Content Negotiation (acceptmarkdown.com)

Wishiva responds natively in Markdown when agents request Accept: text/markdown.

When an AI agent or crawler connects to Wishiva, it does not need to parse messy DOM elements or execute heavy client-side JavaScript. Simply include the standard header:

# Request homepage in pure Markdown

curl -s -H "Accept: text/markdown" https://wishiva.netlify.app/

# Verify Vary header for CDN cache isolation

curl -s -I -H "Accept: text/markdown" https://wishiva.netlify.app/ | grep -i vary

Vary: Accept, Accept-EncodingEnsures Netlify and downstream CDN proxies never serve cached HTML to agents requesting Markdown.

Agent-Friendly 404sNonexistent paths return real HTTP 404 status codes with structured recovery links to prevent crawler traps.

Public REST API Reference

Available public endpoints for querying templates, system health, and submitting feedback.

GET/api/templatesPublic

Retrieve the curated list of digital surprise templates, optionally filtered by occasion.

Query params: ?occasion=birthday | anniversary | bestie | graduation | gratitude

GET/api/healthPublic

Returns the platform operational status, version number, Netlify deployment flag, and agent readiness metrics.

POST/api/feedbackPublic

Submit product feedback, automated test evidence, or bug reports.

Payload: { "rating": 5, "feedback": "Great experience", "category": "agent_audit" }

Netlify Edge Deployment Architecture

Production deployment specifications and edge proxy behaviors.

Edge Middleware Execution

Wishiva runs Next.js Middleware on Netlify Edge Functions. Every incoming request is checked for authentication status, session validity, and Accept headers before reaching origin servers.

Security & Row-Level Security (RLS)

All persistent data is stored in Supabase with strict Postgres Row-Level Security policies. Protected creation dashboards require server-validated sessions, while public wish pages remain securely accessible to recipients.