Developers

    RAAK publishes its public content as read-only JSON, so agents and integrations can read the portfolio without scraping. There is no authentication, no rate limit and no write access. Inquiries go through the contact page.

    Endpoints

    Base URL https://www.raakdesign.com. All responses are application/json, UTF-8, regenerated at every site build. Fields are documented in the OpenAPI description.

    GET/api/v1/projects.json

    All public projects with client, year, sector, services, image and, where available, the case-study text.

    curl https://www.raakdesign.com/api/v1/projects.json | jq '.projects[] | select(.sector == "Medical") | {name, client, url}'

    GET/api/v1/services.json

    The four service phases (strategy, design, engineering, manufacturing) and the sector pages.

    curl https://www.raakdesign.com/api/v1/services.json | jq '.services[].url'

    GET/api/v1/insights.json

    Published insights articles with title, author, dates, standfirst and URL.

    curl https://www.raakdesign.com/api/v1/insights.json | jq '.insights[0]'

    Errors and limits

    The endpoints are static files. A wrong path returns the website's 404 page as HTML, not JSON, so check the status code before parsing. There are no rate limits; please cache responses for at least an hour. The v1 path is stable; a breaking change would be published as v2 with v1 kept for at least twelve months.

    MCP server

    The same data is available as tools over the Model Context Protocol (Streamable HTTP, no authentication, read-only): list_projects, get_project, list_services, list_insights and get_contact_info.

    https://ynbtzjkxhggjauiivhcn.supabase.co/functions/v1/mcp

    Add it to Claude, Cursor or any MCP client as a remote server. Manifest at /.well-known/mcp.json, server card at /.well-known/mcp/server-card.json.

    Other machine-readable resources

    In-page tools for browser agents (WebMCP) are registered on every page when the browser supports document.modelContext: list projects, services and insights, and open the contact page.