Skip to main content

​
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)

1

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.
2

Create a custom GPT

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

Configure authentication

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

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

1

Prerequisites

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

Download the MCP script

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

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"
      }
    }
  }
}
4

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:
Citylocality_idAvailable services
Madrid24017✅ 5 real services
Barcelona21088⚠️ 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