Get Started with Alasco MCP Server

Setup

Before you can use the Alasco MCP server, follow the steps below.

Prerequisites

• You need an MCP client that supports HTTP-based MCP servers. Some compatible clients are listed here.
• Your Alasco account needs to be activated for MCP access. Contact our support team to request access.

Note: the MCP server respects your Alasco access rights and permissions. During authentication, you can select which toolsets to allow and choose between read-only or read-write access.

Connect your client

To connect your MCP client, use the following URL: https://mcp.alasco.de

Then you can start the authentication flow and log in with your Alasco account. The MCP client will then act on your behalf with your access rights and permissions. Make sure to set proper guardrails and/or only allow the tools you want to use.

If asked, choose OAuth 2.0 and Dynamic Client Registration (DCR; sometimes called Dynamic Discovery) for the authentication method.

Note: you can only connect to one Alasco account at a time. To switch accounts, you need to re-authenticate or set up multiple connections (depending on the client).

Compatible Clients

The following clients are known to work with the Alasco MCP server:

• Claude Desktop
• Claude CLI
• Langdock
• Make
• Microsoft Copilot (Studio)
• Cursor
• n8n
• InnoGPT

Capabilities

The Alasco MCP server currently exposes the following capabilities to compatible clients:

FinCon

• Read, create and update projects (including area, volume and usage data) and properties, and read, create, update and delete contracting entities
• Read, create and update contractors, including their tax exemptions
• Search invoices, contracts, change orders, projects, contractors and contract units by name or identifier, and filter lists such as contracting entities, properties, cost elements and tags by name
• Read cost elements and cost element tree templates
• Read, create, update and delete tags and custom field definitions, and read and update custom field values on projects and contracts
• Read, create, update and delete contracts and contract units, and read and update their contract terms
• Read, create, update and delete change orders, and read, create and update invoices
• Complete invoice workflow tasks such as review, approval, payment, delegation and sending back
• Register, edit and delete invoice payments, including partial payments and additional payments on already-paid invoices
• Complete change order workflow tasks such as capturing details, review and approval
• Read and update budget distributions, read, create, update and delete budget shifts, and read budget versions
• Read guarantees and retentions, and read, create, update and delete financial risks
• Read cost financials for projects, contracts, contract units and cost elements
• Read revenue financials, including outright sales, rent units and sales units
• Read income elements, special requests and defects
• Read payment plans, payment requests and their payments, and outright sale payments
• Read a sales unit in full, including its buyers, income elements, payment rates, special requests, defects and payment requests
• Read, create, update and delete contacts
• Read, upload, download and delete documents attached to contracts, invoices and change orders
• Read and create comments on contracts, invoices and change orders
• Read audit-trail records for account changes and authentication events
• Read lenders, financing contracts and their financial overview, including tranches, repayments, fees and interest payments
• Read anonymized market cost benchmarks per DIN 276 cost group, by asset class and region, when budget benchmarking is enabled

ESG

• Read buildings, and find buildings, tenants, data groups and data fields by name, and utility meters by serial or external ID
• Read, create, update and delete utility meters; deleting a meter also removes its readings and consumption data
• Read a building's area allocation, and read, create, update and delete leasable and common building areas
• Update the mapping between building areas and utility meters
• Read, create, update and delete tenants, including lease dates, mapped areas and contact information
• Read, create, update and delete data groups and their data fields
• Read and upload building documents, and create utility-bill processing jobs
• Read available utility contracts and emission factors for a building and year, and assign a utility contract to a landlord-procured meter

Appraisal

• Read, create, update and delete project opportunities and their documents, and find opportunities, calculations and templates by name
• Read, create, update and delete calculations and calculation templates, including locking, archiving and marking a calculation as main
• Patch calculation formulas and review the resulting changes
• Import and export calculations in an LLM-friendly format
• Evaluate, validate and explain calculation structures, including impact analysis
• Read anonymized market cost benchmarks per DIN 276 cost group, by asset class and region

Across all products, you can retrieve the current account and user context and submit feedback about a task result. Compatible clients can also load product guides and workflow prompts where they are provided.

Available tools depend on your enabled products and features, account access, and Alasco permissions.