---
title: "Atlasly Developer Resources — OpenAPI, MCP, OAuth, Webhooks"
description: "Everything developers and AI agents need to integrate with Atlasly — OpenAPI 3.1 spec, hosted MCP server, OAuth 2.1 + PKCE, webhooks, agent authentication guide, and the complete API reference."
canonical: https://atlasly.app/developers
primary_keyword: "Atlasly developer resources"
target_query: "Atlasly API developer documentation OpenAPI MCP"
intent: navigational
---

# Atlasly Developer Resources

> Everything developers and AI agents need to integrate with Atlasly's UK site intelligence platform — OpenAPI 3.1 spec, hosted MCP server, OAuth 2.1 with PKCE, webhooks, and step-by-step guides. Stable predictable URLs for every surface.

## Quick Answer

**Where are the Atlasly developer resources?** Everything is at `https://atlasly.app/developers` or at predictable `.well-known` URLs. OpenAPI 3.1 spec at `/openapi.json`. Hosted MCP server at `mcp.atlasly.app/mcp`. OAuth discovery at `/.well-known/oauth-authorization-server` and `/.well-known/oauth-protected-resource`. MCP server card at `/.well-known/mcp/server-card.json`. Agent-skills index at `/.well-known/agent-skills/index.json`.

## Resources Directory

### Machine-Readable

- **OpenAPI 3.1 Specification** — https://atlasly.app/openapi.json — load in Postman, Insomnia, Swagger UI, or any OpenAPI-aware agent framework
- **API Catalog (RFC 9727)** — https://atlasly.app/.well-known/api-catalog
- **MCP Server Card (SEP-1649)** — https://atlasly.app/.well-known/mcp/server-card.json
- **Agent Skills Discovery (v0.2.0)** — https://atlasly.app/.well-known/agent-skills/index.json
- **OAuth Authorization Server (RFC 8414)** — https://atlasly.app/.well-known/oauth-authorization-server
- **OAuth Protected Resource (RFC 9728)** — https://atlasly.app/.well-known/oauth-protected-resource
- **llms.txt (AI content index)** — https://atlasly.app/llms.txt
- **llms-full.txt (full corpus)** — https://atlasly.app/llms-full.txt

### Human-Readable

- **API Reference** — https://atlasly.app/resources/api
- **MCP Setup Guide (Claude, ChatGPT)** — https://atlasly.app/blog/how-to-use-atlasly-in-claude-chatgpt
- **MCP Tools Reference** — https://atlasly.app/blog/atlasly-mcp-tools-reference-site-analysis
- **Agent Authentication Guide** — https://atlasly.app/blog/agent-authentication-guide-atlasly-api-mcp
- **CAD Export Workflow (AI Chat)** — https://atlasly.app/blog/export-dxf-dwg-site-analysis-from-ai-chat
- **System Status** — https://atlasly.app/resources/status

### Live Endpoints

- **Hosted MCP Server** — https://mcp.atlasly.app/mcp
- **MCP Health** — https://mcp.atlasly.app/mcp/health
- **MCP OAuth Discovery** — https://mcp.atlasly.app/.well-known/oauth-authorization-server
- **MCP Protected Resource Metadata** — https://mcp.atlasly.app/.well-known/oauth-protected-resource/mcp

## Quickstart

### Install the MCP in Claude Desktop (30 seconds)

1. Open Claude Desktop → Settings → Connectors → Add custom connector
2. URL: `https://mcp.atlasly.app/mcp`
3. Save. Seven public tools (analyze_site, check_planning_constraints, get_flood_risk, get_planning_history, find_precedents, get_site_topography, check_walkability_transport) appear immediately.
4. For the four authenticated tools (create_project_from_site, run_site_package, generate_site_brief, enable_site_watch), Claude will prompt an OAuth flow on first call.

### Call the REST API directly

```bash
curl -X POST https://api.atlasly.app/v1/site-analysis \
  -H "Authorization: Bearer $ATLASLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address": "10 Downing Street, London SW1A 2AA"}'
```

Get an API key at https://atlasly.app/profile on a Professional (£14.99/month) or Teams (£49.99/month) plan.

### Generate a client from the OpenAPI spec

```bash
npx @openapitools/openapi-generator-cli generate \
  -i https://atlasly.app/openapi.json \
  -g typescript-fetch \
  -o ./atlasly-client
```

## Authentication

Atlasly supports three authentication modes:

### 1. Anonymous (public MCP tools only)
No credentials required. Rate-limited to 5 calls per 30-day window per anonymous fingerprint.

### 2. OAuth 2.1 with PKCE (recommended for MCP clients)
Discovery at https://mcp.atlasly.app/.well-known/oauth-authorization-server.

Flow:
1. Client registers dynamically via `POST /register` (or uses a pre-registered client_id)
2. User is redirected to `/authorize` with PKCE code_challenge
3. User approves the consent screen at `atlasly.app/mcp/oauth/authorize`
4. Client exchanges the authorization code at `/token` for an access token (and optional refresh token with `offline_access` scope)

Scopes:
- `atlasly.mcp` — call public MCP tools
- `atlasly.projects.write` — create / modify Atlasly projects
- `atlasly.site_package.run` — run the full site intelligence pipeline
- `atlasly.site_watch.write` — configure Site Watch monitoring
- `offline_access` — receive a refresh token for long-lived agent access

### 3. API Key (recommended for programmatic REST use)
Generate at https://atlasly.app/profile (Professional plan or above). Pass as:

```
Authorization: Bearer sk_atlasly_...
```

Full walkthrough: https://atlasly.app/blog/agent-authentication-guide-atlasly-api-mcp

## Webhooks

Configure a webhook URL per API key. Receive signed events when long-running site packages finish.

Event shape:
```json
{
  "event": "site_analysis.completed",
  "site_id": "uuid",
  "timestamp": "2026-04-21T10:30:00Z",
  "result_url": "https://api.atlasly.app/v1/site/..."
}
```

Signature verification: HMAC-SHA256 of the raw body, with your API key as the shared secret, delivered in the `X-Atlasly-Signature` header.

## Rate Limits and Quotas

| Plan | Analyses / month | API calls / month | Concurrent | MCP CAD exports |
|---|---|---|---|---|
| Starter (free) | 5 | n/a | n/a | PDF only |
| Professional (£14.99/mo) | Unlimited | 100 | 10 | All formats |
| Teams (£49.99/mo) | Unlimited | 1,000 | 20 | All formats |
| Enterprise | Custom | Custom | Custom | All formats + private deployment |

Cached site retrievals do not count against quota.

## Support

- Email: hello@atlasly.io
- Status: https://atlasly.app/resources/status
- Enterprise / pilot: https://atlasly.app/pilot

## Links

- Pricing: https://atlasly.app/pricing
- MCP installation: https://atlasly.app/blog/how-to-use-atlasly-in-claude-chatgpt
- Full MCP tools reference: https://atlasly.app/blog/atlasly-mcp-tools-reference-site-analysis
- Agent authentication guide: https://atlasly.app/blog/agent-authentication-guide-atlasly-api-mcp