All articles
    Atlasly agent authentication OAuth API key

    Atlasly MCP Authentication: Discovery, Permissions and Integration Limits

    Connect to Atlasly MCP using current discovery metadata, understand account permissions, and distinguish verified public discovery from unverified private workflows and REST availability.

    ·7 min read·By Shatakshi Patil, Architect

    Quick answer

    Connect to https://mcp.atlasly.app/mcp using a compatible MCP client. Public discovery and 27 unauthenticated tool definitions were verified on 12 September 2026. Account-linked actions require suitable authorization. Use live discovery metadata for authentication; the previously documented api.atlasly.app REST hostname did not resolve during this review, so its old examples should not be used.

    This guide concerns Atlasly at atlasly.app, the site-analysis service for architects and planners. Its verified public MCP endpoint is https://mcp.atlasly.app/mcp. It is not Atlas at atlas.co, AtlasMapping, or MongoDB Atlas.

    Atlasly focuses on UK site research, with England-specific sources for many planning and environmental checks. A successful connection does not establish US planning coverage, complete UK coverage, or that every returned finding is current. Read the coverage and methodology guide alongside this integration guide.

    Reviewed on 12 September 2026: public initialization, tool discovery and authentication metadata responded successfully. This review did not authorize a private account, run a site assessment, or test a paid operation.

    Start with discovery, not a copied token example

    Configure the server URL in the client, then let its MCP connection flow initialize the session and request tools/list. Initialization negotiates a protocol version; tools/list supplies the available names and input schemas.

    The read-only discovery URLs checked in this review were:

    Read these documents afresh when configuring an integration. Do not infer that a protocol revision in an article is the version negotiated by your client; the reviewed initialization response negotiated 2025-03-26.

    What the advertised authorization flow supports

    The live metadata advertises authorization-code and refresh-token grants, public-client token authentication, S256 proof-key challenges, and client metadata document support. Its advertised scope names are atlasly.mcp, atlasly.projects.write, atlasly.site_package.run, atlasly.site_watch.write and offline_access. Scope availability does not establish that an account has a particular entitlement.

    The current MCP authorization specification describes discovery, resource-bound access tokens and the OAuth authorization flow. Use a client implementation that validates state and issuer, uses S256 PKCE, and identifies the intended protected resource in the authorization and token requests. Request only the permissions needed. Do not place a token in a source file, public browser bundle, screenshot or shared log.

    These are integration requirements to verify, not a certification that every Atlasly client or private authentication path has passed an end-to-end compliance test.

    Public research and account-linked actions are different

    Public discovery returned 27 tool definitions without credentials. Availability in that list does not prove a data source will answer a particular site query or establish unlimited production usage. Observe current account terms and any returned service limits.

    The source implementation also defines create_project_from_site, run_site_package, get_job_status, generate_site_brief and enable_site_watch behind account permissions. They were not present in the unauthenticated discovery response. Re-run discovery after authorization and use the schema actually returned for that session. Confirm the requested project action with its owner before saving a project, starting a package or enabling recurring checks.

    Handle expiry, missing permissions and retries explicitly

    Use the authentication challenge and client connection flow when credentials expire. Refresh only when the server issued an eligible refresh token; do not assume a fixed token lifetime or that every connection grants offline access. Store credentials in the client’s supported secure storage and use its disconnect or revocation flow when access is no longer needed.

    A missing tool can reflect authentication or permission differences. A returned error can also mean invalid input, a service limit, unsupported geography or an unavailable source. Keep these cases distinct.

    Do not blindly retry actions that create projects or start work after a timeout: the first request may already have succeeded. Check a returned project or job identifier before repeating a write. Respect retry guidance for read operations and retain the original error for diagnosis.

    REST examples and webhooks are not a verified contract

    The previously published REST hostname api.atlasly.app did not resolve during the public check on 12 September 2026. Public MCP discovery was reachable separately. This guide therefore does not supply a replacement REST request, billing allowance, webhook payload or signature-verification recipe. A backend route found in source is not sufficient evidence of a published production API.

    Consult developer documentation for the current publication status. Obtain a verified base URL, authentication contract, request schema, response examples and operation-specific retry rules before building a REST integration.

    Retain useful evidence without inventing privacy guarantees

    Keep enough diagnostic context to identify the operation and failure, while excluding access tokens and unnecessary project information. Atlasly’s MCP source contains operational logging of tool calls and site location information. This review does not establish a retention period, anonymity guarantee or contractual data-processing terms. Review current terms and the actual information your client sends before using sensitive project material.

    For source interpretation and tool selection, continue with the MCP tools reference.

    Illustrative example

    Illustrative integration check: a practice connects its client, records the negotiated protocol and visible tools, and verifies the site and source coverage before authorizing a saved project action. Successful discovery is recorded separately from a completed assessment. This is a proposed check, not a reported customer result.

    Frequently asked

    Can I inspect Atlasly MCP without an account?

    Yes. Public initialization and 27 tool definitions were available without credentials on 12 September 2026. This check did not execute those tools or establish unlimited usage.

    Does this guide verify private OAuth actions?

    No. It verifies public metadata and compares relevant source implementation. Private authorization, account entitlements and project actions still require an authorized end-to-end check.

    Should I use the old api.atlasly.app example?

    No. That hostname did not resolve during this review. Follow current developer documentation and obtain a verified production REST contract before integrating.

    Does Atlasly MCP cover US planning?

    This review does not establish US planning coverage. Atlasly at atlasly.app focuses on UK site research, with England-specific datasets for many checks. Confirm jurisdiction and source availability for the individual operation.

    Conclusion

    Build against the current session’s discovery and permissions, preserve source limitations, and test each required operation before depending on it. Public MCP availability and a working private or REST workflow are separate evidence claims.

    Atlasly

    About the author

    Shatakshi Patil

    Architect writing about pre-construction due diligence, planning context, and site intelligence workflows for design teams using Atlasly.

    Sources and references

    Authoritative references for the planning policies, regulations, and standards referenced in this article. Always check the publisher for the latest version.

    1. 1MCP authorization specification· Model Context Protocol (Reviewed 12 September 2026)
    2. 2MCP tools specification· Model Context Protocol (Reviewed 12 September 2026)
    3. 3Atlasly authorization metadata· Atlasly (Reviewed 12 September 2026)
    4. 4Atlasly protected-resource metadata· Atlasly (Reviewed 12 September 2026)

    Related articles

    Auto-suggested