Quickstart

Option 1 — Test in 30 seconds (cURL)

Run this in your terminal with your API Key:

curl -X GET \
  "https://qegraxvwwikrltmtfamo.supabase.co/functions/v1/v1-quote-funeral-service?locality_id=24017" \
  -H "Authorization: Bearer YOUR_API_KEY"

Expected response (Madrid, locality_id=24017):

{
  "data": {
    "services": [
      {
        "name": "Funeraria Madrid - Incineración Basic",
        "price": 1495,
        "currency": "EUR",
        "service_type": "cremation",
        "included_items": ["transfer", "basic urn"]
      },
      {
        "name": "Funeraria Madrid - Incineración Completo",
        "price": 1990,
        "currency": "EUR",
        "service_type": "cremation",
        "included_items": ["transfer", "viewing", "urn"]
      },
      {
        "name": "Funerarias Reunidas Madrid",
        "price": 4900,
        "currency": "EUR",
        "service_type": "burial",
        "included_items": ["transfer", "coffin", "ceremony"]
      }
    ],
    "locality": "Madrid",
    "locality_id": 24017
  },
  "meta": {
    "version": "1.0",
    "timestamp": "2026-03-21T10:00:00Z",
    "source": "funos-api",
    "source_ai": "other"
  },
  "cta": {
    "text": "No-commitment consultation at Funos",
    "url": "https://funos.es/?utm_source=ai&utm_medium=api&utm_campaign=funeral-service"
  },
  "error": null
}

Option 2 — Integration in ChatGPT (GPT Action)

Download the YAML configuration file

Request the openapi_gpt_action.yaml file from api@funos.es. This file contains the OpenAPI 3.0 spec ready for GPT Actions.

Create a custom GPT

In ChatGPT → Explore GPTs → Create → Configure → Add Action → Import from URL or paste the YAML content.

Configure authentication

In the Actions screen: Authentication → API Key → Auth Type: Bearer → enter your API Key.

Test the GPT

Ask in the chat: “How much does cremation cost in Madrid?” — the GPT should respond with real Funos prices.

Option 3 — MCP Server for Claude Desktop

Prerequisites

Node.js v18+ installed
Claude Desktop installed
Your Funos API Key

Download the MCP script

Request the funos-mcp-stdio.mjs file from api@funos.es.

Configure Claude Desktop

Edit the file ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on Windows:

{
  "mcpServers": {
    "funos-partner": {
      "command": "/path/to/node",
      "args": ["/path/to/funos-mcp-stdio.mjs"],
      "env": {
        "FUNOS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop

Close and reopen Claude Desktop. You will see the tools icon activated. Ask: “How much does a burial in Madrid cost?”

Finding the locality_id for a city

All quote endpoints use locality_id instead of the city name. Reference localities:

City	locality_id	Available services
Madrid	`24017`	✅ 5 real services
Barcelona	`21088`	⚠️ Coverage expanding

To get the locality_id for any Spanish city, use the /v1-knowledge endpoint with a query like "locality_id Barcelona" — the knowledge base includes locality references.

Next steps

Funeral service

Real-time quotes by locality

Knowledge Base

Semantic search across 6,231 validated entries

Lead Capture

Capture purchase intent from the LLM

Getting started

API Reference

Option 1 — Test in 30 seconds (cURL)

Option 2 — Integration in ChatGPT (GPT Action)

Option 3 — MCP Server for Claude Desktop

Finding the locality_id for a city

Next steps

Funeral service

Knowledge Base

Lead Capture

​Option 1 — Test in 30 seconds (cURL)

​Option 2 — Integration in ChatGPT (GPT Action)

​Option 3 — MCP Server for Claude Desktop

​Finding the locality_id for a city

​Next steps

Funeral service

Knowledge Base

Lead Capture

Option 1 — Test in 30 seconds (cURL)

Option 2 — Integration in ChatGPT (GPT Action)

Option 3 — MCP Server for Claude Desktop

Finding the locality_id for a city

Next steps