{"openapi":"3.1.0","info":{"title":"Alasco Fincon (BYOK) API","version":"0.1.0","description":"Alasco Fincon (BYOK) lets an AI assistant read your own Alasco Fincon data through the Alasco Fincon API with a key you supply (Alasco API key). Read-only: 12 tools (list_projects, get_project, list_properties, list_contract_units, list_contracts, get_contract, list_change_orders, list_invoices, list_budget_shifts, list_cost_elements, list_project_financials, list_contract_financials). The BYOK...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-alasco-fincon.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-alasco-fincon/docs"},"termsOfService":"https://connectorbay.com/byok-alasco-fincon/terms"},"servers":[{"url":"https://byok-alasco-fincon.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-alasco-fincon/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_projects":{"post":{"operationId":"list_projects","summary":"List the real estate development projects of your Alasco account with identifier, description, property, floor areas, us","description":"List the real estate development projects of your Alasco account with identifier, description, property, floor areas, usage, planned start and end dates, default tax rate and active flag. Money amounts come back as objects with net and tax values. Uses cursor paging through links.next. Use for \"Which development projects are in Alasco\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the value of the cursor[position] query parameter inside the links.next URL of the previous answer (omit for the first page).","title":"Cursor"},"name_contains":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items whose name contains this text.","title":"Name Contains"}},"title":"list_projectsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_project":{"post":{"operationId":"get_project","summary":"Get one Alasco project with identifier, description, property, areas, usage, planned dates and default contracting entit","description":"Get one Alasco project with identifier, description, property, areas, usage, planned dates and default contracting entity. Use for \"Show Alasco project 5f3a1c2e\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Project id, from the list tool.","maxLength":200,"title":"Id","type":"string"}},"required":["id"],"title":"get_projectArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_properties":{"post":{"operationId":"list_properties","summary":"List the properties (sites and buildings) of your Alasco account with name, description, address, zip code, city, countr","description":"List the properties (sites and buildings) of your Alasco account with name, description, address, zip code, city, country and creation date. Money amounts come back as objects with net and tax values. Uses cursor paging through links.next. Use for \"Which properties are in Alasco\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the value of the cursor[position] query parameter inside the links.next URL of the previous answer (omit for the first page).","title":"Cursor"},"name_contains":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items whose name contains this text.","title":"Name Contains"}},"title":"list_propertiesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_contract_units":{"post":{"operationId":"list_contract_units","summary":"List the contract units (budget groups of contracts inside a project) with name, project and state. Money amounts come b","description":"List the contract units (budget groups of contracts inside a project) with name, project and state. Money amounts come back as objects with net and tax values. Uses cursor paging through links.next. Use for \"Which contract units does Alasco project 5f3a1c2e have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the value of the cursor[position] query parameter inside the links.next URL of the previous answer (omit for the first page).","title":"Cursor"},"name_contains":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items whose name contains this text.","title":"Name Contains"},"project_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only items of this project id.","title":"Project Id"}},"title":"list_contract_unitsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_contracts":{"post":{"operationId":"list_contracts","summary":"List the contracts of your Alasco projects with name, number, type, status, contract date, contract unit, contractor id,","description":"List the contracts of your Alasco projects with name, number, type, status, contract date, contract unit, contractor id, cost center, reverse-charge flag and contract amount. Money amounts come back as objects with net and tax values. Uses cursor paging through links.next. Use for \"Which contracts are signed on Alasco project 5f3a1c2e\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the value of the cursor[position] query parameter inside the links.next URL of the previous answer (omit for the first page).","title":"Cursor"},"name_contains":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items whose name contains this text.","title":"Name Contains"},"project_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only items of this project id.","title":"Project Id"}},"title":"list_contractsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_contract":{"post":{"operationId":"get_contract","summary":"Get one Alasco contract with number, type, status, date, contract unit, contractor id, cost center, reverse-charge flag,","description":"Get one Alasco contract with number, type, status, date, contract unit, contractor id, cost center, reverse-charge flag, amount and reserve amount. Use for \"Show Alasco contract 5f3a1c2e\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Contract id, from the list tool.","maxLength":200,"title":"Id","type":"string"}},"required":["id"],"title":"get_contractArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_change_orders":{"post":{"operationId":"list_change_orders","summary":"List the change orders (claims for additional work) with identifier, name, contract, trigger, basis of claim, state and ","description":"List the change orders (claims for additional work) with identifier, name, contract, trigger, basis of claim, state and claimed, audited and approved amounts. Money amounts come back as objects with net and tax values. Uses cursor paging through links.next. Use for \"Which change orders are open on Alasco project 5f3a1c2e\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the value of the cursor[position] query parameter inside the links.next URL of the previous answer (omit for the first page).","title":"Cursor"},"name_contains":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items whose name contains this text.","title":"Name Contains"},"project_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only items of this project id.","title":"Project Id"}},"title":"list_change_ordersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_invoices":{"post":{"operationId":"list_invoices","summary":"List the invoices booked against contracts with internal and external number, type, process state, dates received, poste","description":"List the invoices booked against contracts with internal and external number, type, process state, dates received, posted, due and approved, and audited, approved and payment amounts. Money amounts come back as objects with net and tax values. Uses cursor paging through links.next. Use for \"Which invoices are overdue in Alasco\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the value of the cursor[position] query parameter inside the links.next URL of the previous answer (omit for the first page).","title":"Cursor"},"include":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Related objects to include, comma separated, for example contract or contract.contractor.","title":"Include"}},"title":"list_invoicesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_budget_shifts":{"post":{"operationId":"list_budget_shifts","summary":"List the budget shifts between contract units with type, reason, amount, project, source and target contract unit and cr","description":"List the budget shifts between contract units with type, reason, amount, project, source and target contract unit and creation date. Money amounts come back as objects with net and tax values. Uses cursor paging through links.next. Use for \"Which budget shifts happened on Alasco projects\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the value of the cursor[position] query parameter inside the links.next URL of the previous answer (omit for the first page).","title":"Cursor"}},"title":"list_budget_shiftsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_cost_elements":{"post":{"operationId":"list_cost_elements","summary":"List the cost elements (cost structure items such as DIN 276 groups) with name, description, category, parent and tree t","description":"List the cost elements (cost structure items such as DIN 276 groups) with name, description, category, parent and tree template. Money amounts come back as objects with net and tax values. Uses cursor paging through links.next. Use for \"Which cost elements are defined in Alasco\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the value of the cursor[position] query parameter inside the links.next URL of the previous answer (omit for the first page).","title":"Cursor"},"name_contains":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items whose name contains this text.","title":"Name Contains"}},"title":"list_cost_elementsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_project_financials":{"post":{"operationId":"list_project_financials","summary":"Report the financials of each project: initial and current budget, main contract amount, change orders, approved and pai","description":"Report the financials of each project: initial and current budget, main contract amount, change orders, approved and paid amounts, forecasts, deviations, reserves and risk. Money amounts come back as objects with net and tax values. Uses cursor paging through links.next. Use for \"What is the budget and forecast of each Alasco project\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the value of the cursor[position] query parameter inside the links.next URL of the previous answer (omit for the first page).","title":"Cursor"}},"title":"list_project_financialsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_contract_financials":{"post":{"operationId":"list_contract_financials","summary":"Report the financials of each contract: main contract amount, change orders, approved and paid amounts, retentions, disc","description":"Report the financials of each contract: main contract amount, change orders, approved and paid amounts, retentions, discounts, forecasts, reserves and risk. Money amounts come back as objects with net and tax values. Uses cursor paging through links.next. Use for \"How much has been paid against each Alasco contract\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: the value of the cursor[position] query parameter inside the links.next URL of the previous answer (omit for the first page).","title":"Cursor"}},"title":"list_contract_financialsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}