Developer access
Subscriber API and MCP access for SSCD dataset integrations.
Paying subscriber accounts can authenticate with a generated API key and use the SSCD dataset over REST or MCP. Use the account page to create keys, then integrate against the endpoints below.
Auth
Send the generated account key as `Authorization: Bearer <api-key>` or ` x-api-key`. Keys are account-scoped and intended for server-to-server access.
REST example
curl -H "Authorization: Bearer SSCD_API_KEY" "https://sscd.accomplice-dev.se/api/v1/centres?county=Stockholm&limit=10"MCP
HTTP-capable MCP clients can connect directly to the streamable endpoint at ` /api/mcp` using the same API key.
Direct MCP config
{
"mcpServers": {
"sscd": {
"url": "https://sscd.accomplice-dev.se/api/mcp",
"headers": {
"Authorization": "Bearer SSCD_API_KEY"
}
}
}
}Stdio bridge
For clients that only accept stdio MCP servers, use `mcp-remote` as an HTTP bridge in front of the SSCD MCP endpoint.
mcp-remote config
{
"mcpServers": {
"sscd": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://sscd.accomplice-dev.se/api/mcp",
"--header",
"Authorization: Bearer SSCD_API_KEY"
]
}
}
}Endpoints
Machine-readable routes
The dataset is exposed through versioned REST routes and a single MCP endpoint.
/api/v1/metadata/api/v1/metadataDataset columns, scopes, and discovery metadata.
/api/v1/centres/api/v1/centresSearch and paginate shopping centres.
/api/v1/centres/{slug}/api/v1/centres/{slug}Read a full centre record by slug.
/api/v1/projects/api/v1/projectsSearch and paginate planned retail projects.
/api/v1/projects/{slug}/api/v1/projects/{slug}Read a full project record by slug.
/api/mcp/api/mcpStreamable HTTP MCP endpoint for LLM tools and resources.
Centres dataset
Column names are stable and can be used in API filters, documentation lookups, and MCP tool prompts.
| Column | Type | Use | Flags |
|---|---|---|---|
| id | string | Internal centre identifier. | Read only |
| slug | string | Stable slug used in URLs and detail lookups. | Filter / Sort |
| legacyCode | string | Legacy source-system identifier when present. | Filter |
| name | string | Centre name. | Filter / Sort |
| type | string | Centre type classification. | Filter / Sort |
| county | string | County name. | Filter / Sort |
| municipality | string | Municipality name. | Filter / Sort |
| regionName | string | Source region label when available. | Filter |
| streetAddress | string | Street address. | Filter |
| postalCode | string | Postal code. | Filter |
| latitude | number | Latitude in WGS84 decimal degrees. | Read only |
| longitude | number | Longitude in WGS84 decimal degrees. | Read only |
| covered | boolean | Whether the centre is covered. | Filter |
| floors | number | Number of floors. | Filter |
| parkingSpaces | number | Parking space count. | Filter |
| openingYear | number | Original opening year. | Filter |
| homepageUrl | string | Public centre website URL. | Read only |
| owners | string[] | Owning organizations attached to the centre. | Filter |
| anchorTenants | string[] | Anchor tenant brands attached to the centre. | Filter |
| latestMetricYear | number | Most recent metric snapshot year. | Filter / Sort |
| visitorsMillions | number | Latest recorded annual visitors in millions. | Filter / Sort |
| totalTenantCount | number | Latest recorded total tenant count. | Filter / Sort |
| totalGlaSqm | number | Latest gross leasable area. | Filter / Sort |
| commonAreaSqm | number | Latest common area size. | Filter |
| totalAreaSqm | number | Latest total area size. | Filter |
| retailSalesMsek | number | Latest retail sales in mSEK. | Filter / Sort |
| totalSalesMsek | number | Latest total sales in mSEK. | Filter / Sort |
| retailSalesPerSqmSek | number | Latest retail sales density. | Filter |
| totalSalesPerSqmSek | number | Latest total sales density. | Filter |
| publishedAt | date | Publishing timestamp. | Read only / Sort |
| updatedAt | date | Application update timestamp. | Read only / Sort |
Projects dataset
Planned projects follow the same approach, with search-friendly fields and stable response keys.
| Column | Type | Use | Flags |
|---|---|---|---|
| id | string | Internal project identifier. | Read only |
| slug | string | Stable slug used in URLs and detail lookups. | Filter / Sort |
| name | string | Project name. | Filter / Sort |
| centreSlug | string | Related centre slug when linked. | Filter |
| county | string | County name. | Filter / Sort |
| municipality | string | Municipality name. | Filter / Sort |
| type | string | Centre type classification. | Filter / Sort |
| planningStage | string | Current planning stage. | Filter / Sort |
| planningType | string | Planning type or category. | Filter |
| propertyDesignation | string | Property designation from source data. | Filter |
| areaDescription | string | Free-text area or district description. | Filter |
| latitude | number | Latitude in WGS84 decimal degrees. | Read only |
| longitude | number | Longitude in WGS84 decimal degrees. | Read only |
| existingGlaSqm | number | Existing area affected by the project. | Filter |
| newGlaSqm | number | Planned new area. | Filter / Sort |
| constructionStartYear | number | Expected construction start year. | Filter |
| plannedOpeningYear | number | Expected opening year. | Filter / Sort |
| newTenantCount | number | Expected number of new tenants. | Filter |
| signedAnchorTenants | string | Signed anchor tenant notes. | Filter |
| signedTenants | string | Signed tenant notes. | Filter |
| owners | string[] | Owning organizations attached to the project. | Filter |
| updatedSourceAt | date | Timestamp from the source workbook. | Read only / Sort |
| updatedAt | date | Application update timestamp. | Read only / Sort |