Newton MCP server

Prebuilt SnapLogic agentic-tool pipelines that let an LLM read from and act on Newton, callable as MCP tools via Pipeline Execute. Published in the SnapLogic pattern catalog.

Overview

This tool pack connects an agent to Newton Revantage, the real estate legal-entity, asset, and treasury platform. It covers searching assets, entities, contacts, projects, financings, and reference data; fetching any resource by ID; listing board directors; and creating or updating banks and bank accounts.

For setup instructions, see SnapLogic MCP Server quickstart.

Example Prompts

  • Add Deutsche Bank to Newton, BIC DEUTDEFF
  • Create a bank record for ING with BIC INGBNL2A and SEPA enabled
  • Register a new bank with local bank code 50070010
  • Set up a bank called Rabobank and mark it inactive for now
  • Open a bank account for entity 42 at bank 5, IBAN NL91ABNA0417164300
  • Create a EUR operating account for this entity with an opening date of 15 January
  • Add a bank account with account number 12345678 for entity 17 and tie it to project 88
  • Set up a new account for this entity and note that it's the rent collection account
  • Who are the board directors across our entities?
  • Give me the full list of governing body directors

Tools

Tool Name Functions
NewtonCreateBank Register a new bank in Newton from a name and SWIFT/BIC code.
NewtonCreateBankAccount Create a bank account for a Newton legal entity against a given bank.
NewtonCreateBankAccountChild Child pipeline for NewtonCreateBankAccount.
NewtonCreateBankChild Child pipeline for NewtonCreateBank.
NewtonGetBoardDirectors List all director contacts across Newton governing bodies.
NewtonGetResourceById Fetch any Newton resource by type and ID.
NewtonListResources Page through any simple Newton collection by resource type.
NewtonSearchAssets Search Newton assets by active status and project, with optional related-data expansion.
NewtonSearchContacts Find Newton contacts by active/internal status, umbrella, group or ID.
NewtonSearchEntities Search legal entities by name or ID, with deep governance and compliance expansion.
NewtonSearchFinancings Search Newton financings, expanding borrowers, facilities, hedging and syndications.
NewtonSearchOptions Look up Newton reference options by group, to resolve or decode ID-valued fields.
NewtonSearchProjects Search Newton projects by name, status or ID, with structure and funding expansion.
NewtonSearchUsTaxPlannings Retrieve US tax planning records by entity IDs and reference year.
NewtonUpdateBank Partially update an existing Newton bank by ID.
NewtonUpdateBankAccount Partially update a Newton bank account by ID, including closing it.
NewtonUpdateBankAccountChild Child pipeline for NewtonUpdateBankAccount.
NewtonUpdateBankChild Child pipeline for NewtonUpdateBank.

Set up the MCP Server tools

  1. Download newton_tools.zip.
  2. In SnapLogic Designer, open the target project space (or create one), then choose Import Project / Import Pipelines and select the downloaded newton_tools.zip. Designer unpacks each pipeline into the project.
  3. Attach the required account to the connectivity snaps (see Connection Setup).
  4. Expose the project as an MCP server — each pipeline becomes a tool named after its label. New to this? Start with the MCP quickstart, then use the MCP Server Pipeline Builder to generate the server from the imported pipelines.

Configure account

Attach an API Suite account (OAuth 2.0 or Bearer token) to the HTTP Client snap in Designer after import.

These pipelines ship without credentials by design — attach a valid account in Designer before the tools will execute.

See the SnapLogic account documentation for this connector: API Suite Account Configuration.

Important: These pipelines ship without credentials by design — attach a valid account in Designer before the tools will execute. Credentials live in the SnapLogic account store, never in the pipeline JSON.

NewtonCreateBank

Registers a new bank in Newton with a name and SWIFT/BIC code, plus optional details such as a local bank code, notes, and SEPA capability. Use it to add a bank to Newton before creating bank accounts that reference it.

Parameter Type Default Description
name* string

Bank name, sent as name on the POST body, e.g. Deutsche Bank.

swiftBic* string

SWIFT/BIC code of the bank, e.g. DEUTDEFF.

active string true

Whether the bank is active: true or false, sent as a boolean (default true).

localBankCode string

Local/national bank code, e.g. 50070010. Omitted from the body when blank.

info string

Free-text notes stored on the bank record. Omitted from the body when blank.

specialInfo string

Additional free-text notes stored in the bank's special information field. Omitted when blank.

sepaEnabled string

SEPA capability flag: true or false, sent to Newton as 1 or 0. Omitted when blank.

* Required parameter.

Try asking:

  • Add Deutsche Bank to Newton, BIC DEUTDEFF
  • Create a bank record for ING with BIC INGBNL2A and SEPA enabled
  • Register a new bank with local bank code 50070010
  • Set up a bank called Rabobank and mark it inactive for now

NewtonCreateBankAccount

Creates a new bank account in Newton for a legal entity, linked to a bank by ID, with an account number or IBAN. Optional fields let you specify currency, project, dates, classification, and free-text notes.

Parameter Type Default Description
accountNumber* string

Bank account number, e.g. 12345678. Required unless iban is supplied.

iban* string

IBAN of the account, e.g. NL91ABNA0417164300. Required unless accountNumber is supplied.

entityId* string

ID of the legal entity the account belongs to, sent as an integer, e.g. 42.

bankId* string

ID of the bank holding the account, from Newton's banks collection, sent as an integer.

projectId string

Project ID to tie the account to, e.g. 88. Omitted from the body when blank.

typeId string

Account type ID from the bank_account_type% options group. Omitted when blank.

categoryId string

Account category ID from the bank_account_category options group. Omitted when blank.

currencyId string

Currency ID from Newton's currencies collection. Omitted when blank.

statusId string

Account status ID from the bank_account_status options group. Omitted when blank.

classificationId string

Account classification ID from the bank_account_classification options group. Omitted when blank.

activationDate string

Date the account becomes active, as an ISO date. Omitted when blank.

openingDate string

Date the account was opened, as an ISO date. Omitted when blank.

information string

Free-text notes stored on the account, e.g. rent collection account. Omitted when blank.

* Required parameter.

Try asking:

  • Open a bank account for entity 42 at bank 5, IBAN NL91ABNA0417164300
  • Create a EUR operating account for this entity with an opening date of 15 January
  • Add a bank account with account number 12345678 for entity 17 and tie it to project 88
  • Set up a new account for this entity and note that it's the rent collection account

NewtonCreateBankAccountChild

Child pipeline for NewtonCreateBankAccount. Receives the full document from the parent, shapes the payload, and POSTs to Newton /bank-accounts endpoint. Do not call directly — use the parent NewtonCreateBankAccount pipeline. Configuration: Pipeline params (capture=False, passed by parent): - base_url: Newton API base URL

No parameters.

NewtonCreateBankChild

Child pipeline for NewtonCreateBank. Shapes payload and POSTs to Newton /banks. Do not call directly — use the parent NewtonCreateBank pipeline. Pipeline params (capture=False, passed by parent): - base_url: Newton API base URL

No parameters.

NewtonGetBoardDirectors

Lists all contacts holding director seats across Newton governing bodies, with paging. Use it for board composition analysis, multi-mandate checks, or to answer questions about who sits on which board.

Parameter Type Default Description
page string 1

Page number of the director list to fetch (default 1).

limit string 25

Number of director contacts returned per page (default 25).

Try asking:

  • Who are the board directors across our entities?
  • Give me the full list of governing body directors
  • Show me the next page of directors, 100 at a time
  • Which people hold director seats in Newton?

NewtonGetResourceById

Fetches the full detail of a single Newton record, using the resource type and ID to route across any Newton collection. Use it as a follow-up to a search or list call when you need the complete record.

Parameter Type Default Description
resource_type* string entities

Newton collection the record lives in, used as the URL path segment — one of assets, entities, contacts, projects, financings, funds, fund-general-partners, fundentities, documents, vendors, banks, bank-accounts, collections, countries, options, services, recharges, review-events, operational-sizes, us-tax-plannings, icoparameters, identificationnumbers.

id* string 1

Unique identifier of the record within that collection, e.g. 42.

* Required parameter.

Try asking:

  • Get entity 42
  • Show me the full record for bank account 118
  • Look up vendor 9 in Newton
  • Fetch document 3301
  • Give me the details on fund 27

NewtonListResources

Pages through any Newton collection that does not support rich filtering, such as funds, banks, vendors, currencies, or audit logs. For assets, entities, contacts, projects, and financings, use the dedicated search tools instead.

Parameter Type Default Description
resource_type* string funds

Newton collection to page through, used as the URL path segment — one of funds, fund-general-partners, fundentities, documents, vendors, banks, bank-accounts, collections, countries, currencies, options, services, recharges, review-events, operational-sizes, icoparameters, identificationnumbers, audit-logs.

page string 1

Page number of the collection to fetch (default 1).

limit string 25

Number of records returned per page (default 25).

* Required parameter.

Try asking:

  • List all the banks in Newton
  • Show me the available currencies
  • Browse the vendor list, 50 at a time
  • What funds are registered?
  • Give me the second page of audit logs

NewtonSearchAssets

Searches Newton real estate assets by active status and project, with the option to expand related data such as loans, land register information, and operational sizes in the same call. Results are paginated.

Parameter Type Default Description
active string activeOnly

Active-status filter sent to the assets endpoint: activeOnly, inactiveOnly or any (default activeOnly).

project string

Project ID to restrict assets to, e.g. 217. Omit to search across all projects.

contain string

Comma-separated related data to expand inline, from classes, projects, customFields, businessRelations, assetLoans, landRegisterInformation, operationalSizes.

page string 1

Page number of results to fetch (default 1).

limit string 25

Number of assets returned per page (default 25).

Try asking:

  • List the active assets on project 217
  • Show me all assets including their land register information
  • Which assets have asset loans attached? Include the loan details
  • Pull the first 50 inactive assets
  • Get assets for this project with their classes and operational sizes

NewtonSearchContacts

Searches Newton contacts by active status, internal flag, umbrella or group membership, or a list of IDs, with optional expansion of groups and address details. Use it to look up people or enumerate group members.

Parameter Type Default Description
active string

Active-status filter on contacts: true or false. Omit to include both.

internal string

Internal-contact filter: true for internal people, false for external. Omit for both.

umbrellas string

Comma-separated umbrella IDs to restrict contacts to.

groups string

Comma-separated contact group IDs to restrict contacts to, e.g. 7.

contain string

Comma-separated relations to expand inline, from groups, umbrella, businessAddress.

fields string

Comma-separated contact fields to return, from id, firstName, middleName, lastName, company, active, email, internal.

ids string

Comma-separated contact IDs to fetch instead of filtering, max 20, e.g. 101,102,103.

page string 1

Page number of results to fetch (default 1).

limit string 25

Number of contacts returned per page (default 25).

Try asking:

  • Find all active internal contacts
  • Who's in contact group 7? Include their email addresses
  • Look up contacts 101, 102 and 103 with their business addresses
  • List external contacts under the Revantage umbrella
  • Give me just the names and emails of active contacts

NewtonSearchEntities

Searches Newton's legal entity register by name or ID, with deep expansion of governance structures, compliance records, share capitals, and debt tranches. Use it for questions about who governs an entity, its capital structure, or the status of its compliance filings.

Parameter Type Default Description
active string activeOnly

Active-status filter sent to the entities endpoint: activeOnly, inactiveOnly or any (default activeOnly).

name string

Text searched against the legal entity name, e.g. Revantage.

ids string

Comma-separated entity IDs to fetch instead of searching, max 20, e.g. 12,15,44.

contain string

Comma-separated relations to expand inline, from funds, projects, resolvedGoverningBody, corporateAccountant, corporateOfficer, vatCompliance, citCompliance, accountManager, administrator, bxSubDeals, advisoryCommittee, supervisoryBoard, signatoryPowerRules, formerGoverningBody, formerAdvisoryCommittee, formerSupervisoryBoard, formerEntityNames, shareCapitals, authorizedShareCapitals, debtTranches, demergedFromEntities, buyers, taxCompliances, ctbCompliance, fatcaCompliances, crsCompliances, formReceiversCompliances, kycCompliances, uboCompliances, uboFormCompliances, dataUnderVerification, stockListings.

fields string

Comma-separated entity field names to return, for a sparse response, e.g. id,name.

page string 1

Page number of results to fetch (default 1).

limit string 25

Number of entities returned per page (default 25).

Try asking:

  • Find the legal entities with 'Revantage' in the name
  • Show me this entity's governing body and supervisory board
  • Which entities have outstanding KYC or UBO compliance records?
  • Get entities 12, 15 and 44 with their share capitals and debt tranches
  • List active entities and just return the id and name fields
  • Pull the signatory power rules for these entities

NewtonSearchFinancings

Retrieves Newton financing and loan arrangements, optionally filtered by status or a list of IDs, with expansion of borrowers, facilities, hedging, syndications, and covenant review details. Use it for questions about debt structures and repayment obligations.

Parameter Type Default Description
active string activeOnly

Active-status filter sent to the financings endpoint: activeOnly, inactiveOnly or any (default activeOnly).

ids string

Comma-separated financing IDs to fetch instead of filtering, max 20, e.g. 340.

contain string

Comma-separated relations to expand inline, from borrowers, debtReviews, extensionOptions, facilities, guarantors, hedgings, ipdRequirements, ipdSchedules, syndications.

page string 1

Page number of results to fetch (default 1).

limit string 25

Number of financings returned per page (default 25).

Try asking:

  • List the active financings with their borrowers and facilities
  • Which financings have hedging in place?
  • Show me the IPD schedules for financing 340
  • Get the guarantors and syndication detail on these financings
  • What extension options exist on our current loans?

NewtonSearchOptions

Looks up Newton reference and enum values, scoped to an option group or a list of IDs, so an agent can resolve human phrases into the numeric IDs that write tools expect. Use it before creating or updating records to find valid type, category, status, and classification IDs.

Parameter Type Default Description
group string

Option group name to scope the lookup to — lowercase with underscores, % wildcard supported, e.g. bank_account_type%.

contain string

Comma-separated relations to expand inline; attributes is the only supported value.

ids string

Comma-separated option IDs to fetch instead of filtering, max 20.

page string 1

Page number of results to fetch (default 1).

limit string 25

Number of options returned per page (default 25).

Try asking:

  • What bank account types are available?
  • List the valid bank account statuses with their IDs
  • What does statusId 3 mean on a bank account?
  • Show me the contact group options
  • Find all cashbook category options including their attributes

NewtonSearchProjects

Searches Newton real estate projects by name, status, or ID, with optional expansion of ownership structure, funding details, and joint venture partners. Use it when the user asks about a deal's shape, partners, or funding sources.

Parameter Type Default Description
active string activeOnly

Active-status filter sent to the projects endpoint: activeOnly, inactiveOnly or any (default activeOnly).

name string

Text searched against the project name, e.g. Nordkai.

ids string

Comma-separated project IDs to fetch instead of searching, max 20, e.g. 88,91.

contain string

Comma-separated relations to expand inline, from entities, funds, structureChartBooks, amounts, jointVenturePartners, sourcesAndUses.

page string 1

Page number of results to fetch (default 1).

limit string 25

Number of projects returned per page (default 25).

Try asking:

  • Find the project called 'Nordkai'
  • Show me active projects with their joint venture partners
  • What are the sources and uses on project 88?
  • List projects with the entities and funds attached to them
  • Pull all inactive projects, 50 per page

NewtonSearchUsTaxPlannings

Retrieves US tax planning records from Newton, optionally filtered by legal entity IDs and reference year. Use it to review the tax planning position for one or more entities in a given filing year.

Parameter Type Default Description
entityIds string

Comma-separated legal entity IDs to filter by, max 20, e.g. 1,2,3.

year string

Reference year of the tax planning records, e.g. 2026. Omit and Newton falls back to the current year.

page string 1

Page number of results to fetch (default 1).

limit string 25

Number of records returned per page (default 25).

Try asking:

  • Show me the 2026 US tax plannings for entities 1, 2 and 3
  • What US tax planning records exist for this entity?
  • Pull last year's US tax plannings
  • List all US tax planning records for the current year

NewtonUpdateBank

Partially updates an existing Newton bank by ID, sending only the fields you supply. Use it to correct a BIC code, change the active status, or update notes on a bank record.

Parameter Type Default Description
id* string

ID of the bank to update; appended to the /banks path of the PATCH call.

name string

New bank name. Omitted from the PATCH body when blank.

swiftBic string

New SWIFT/BIC code, e.g. INGBNL2A. Omitted when blank.

active string

New active flag: true or false, sent as a boolean. Omitted when blank.

localBankCode string

New local/national bank code. Omitted when blank.

info string

Free-text notes to store on the bank record. Omitted when blank.

specialInfo string

Additional free-text notes for the bank's special information field. Omitted when blank.

sepaEnabled string

SEPA capability flag: true or false, sent to Newton as 1 or 0. Omitted when blank.

* Required parameter.

Try asking:

  • Rename bank 5 to 'Deutsche Bank AG'
  • Mark bank 12 as inactive
  • Fix the BIC on bank 7 — it should be INGBNL2A
  • Enable SEPA on bank 3
  • Add a note to bank 9 saying it was merged last quarter

NewtonUpdateBankAccount

Partially updates an existing Newton bank account by ID, sending only the fields you supply. Use it to correct account details, re-assign the account to a different entity or project, or close the account by setting a closing date.

Parameter Type Default Description
id* string

ID of the bank account to update; appended to the /bank-accounts path of the PATCH call.

accountNumber string

New bank account number. Omitted from the PATCH body when blank.

iban string

New IBAN for the account, e.g. NL91ABNA0417164300. Omitted when blank.

entityId string

Legal entity ID to reassign the account to, sent as an integer. Omitted when blank.

bankId string

Bank ID to reassign the account to, sent as an integer. Omitted when blank.

projectId string

Project ID to tie the account to, e.g. 91. Omitted when blank.

typeId string

Account type ID from the bank_account_type% options group. Omitted when blank.

categoryId string

Account category ID from the bank_account_category options group. Omitted when blank.

currencyId string

Currency ID from Newton's currencies collection. Omitted when blank.

statusId string

Account status ID from the bank_account_status options group. Omitted when blank.

classificationId string

Account classification ID from the bank_account_classification options group. Omitted when blank.

activationDate string

Date the account becomes active, as an ISO date. Omitted when blank.

closingDate string

Date the account is closed, as an ISO date — set this to close an account. Omitted when blank.

information string

Free-text notes stored on the account. Omitted when blank.

* Required parameter.

Try asking:

  • Close bank account 123 with a closing date of 31 March
  • Change the status on account 118 to dormant
  • Reassign bank account 204 to project 91
  • Update the IBAN on account 77
  • Add a note to bank account 123 about the mandate change

NewtonUpdateBankAccountChild

Child pipeline for NewtonUpdateBankAccount. Receives the full document, shapes non-null fields into PATCH payload, calls Newton PATCH /bank-accounts/{id}. Do not call directly — use the parent NewtonUpdateBankAccount pipeline. Pipeline params (capture=False, passed by parent): - base_url: Newton API base URL - id: Bank account ID to PATCH

Parameter Type Default Description
id string

NewtonUpdateBankChild

Child pipeline for NewtonUpdateBank. Shapes payload and PATCHes Newton /banks/{id}. Do not call directly — use the parent NewtonUpdateBank pipeline. Pipeline params (capture=False, passed by parent): - base_url: Newton API base URL - id: Bank ID to PATCH

Parameter Type Default Description
id string