> ## Documentation Index
> Fetch the complete documentation index at: https://developers.funos.es/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get your first response with real Funos prices in under 5 minutes.

## Option 1 — Test in 30 seconds (cURL)

Run this in your terminal with your API Key:

```bash theme={null}
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):

```json theme={null}
{
  "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)

<Steps>
  <Step title="Download the YAML configuration file">
    Request the `openapi_gpt_action.yaml` file from [api@funos.es](mailto:api@funos.es). This file contains the OpenAPI 3.0 spec ready for GPT Actions.
  </Step>

  <Step title="Create a custom GPT">
    In ChatGPT → Explore GPTs → Create → Configure → Add Action → Import from URL or paste the YAML content.
  </Step>

  <Step title="Configure authentication">
    In the Actions screen: Authentication → API Key → Auth Type: **Bearer** → enter your API Key.
  </Step>

  <Step title="Test the GPT">
    Ask in the chat: *"How much does cremation cost in Madrid?"* — the GPT should respond with real Funos prices.
  </Step>
</Steps>

***

## Option 3 — MCP Server for Claude Desktop

<Steps>
  <Step title="Prerequisites">
    * Node.js v18+ installed
    * Claude Desktop installed
    * Your Funos API Key
  </Step>

  <Step title="Download the MCP script">
    Request the `funos-mcp-stdio.mjs` file from [api@funos.es](mailto:api@funos.es).
  </Step>

  <Step title="Configure Claude Desktop">
    Edit the file `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or the equivalent on Windows:

    ```json theme={null}
    {
      "mcpServers": {
        "funos-partner": {
          "command": "/path/to/node",
          "args": ["/path/to/funos-mcp-stdio.mjs"],
          "env": {
            "FUNOS_API_KEY": "YOUR_API_KEY"
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Restart Claude Desktop">
    Close and reopen Claude Desktop. You will see the tools icon activated. Ask: *"How much does a burial in Madrid cost?"*
  </Step>
</Steps>

***

## 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 |

<Tip>
  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.
</Tip>

***

## Next steps

<CardGroup cols={3}>
  <Card title="Funeral service" icon="house" href="/en/api-reference/servicio-funerario">
    Real-time quotes by locality
  </Card>

  <Card title="Knowledge Base" icon="book" href="/en/api-reference/knowledge-base">
    Semantic search across 6,231 validated entries
  </Card>

  <Card title="Lead Capture" icon="user-plus" href="/en/api-reference/lead-capture">
    Capture purchase intent from the LLM
  </Card>
</CardGroup>