# Salesforce

Source: https://pilot.braike.com/en/docs/regies/salesforce

The 19 tools Pilot MCP serves for Salesforce: 16 read-only, and 3 that write with the €29 plan, taken from the server.

Pilot MCP serves **16 read-only tools** for Salesforce, on every plan. With the €29 plan, it also serves **2** that create or change and **1** that delete. Their names start with `salesforce_`.

<Callout title="What each entry shows">
The name, description and parameters come from the list the server serves to your assistant (`tools/list`). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
</Callout>

<Callout title="Writing and deleting">
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See [Read and write](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 16 |
| [Create and change (€29)](#modification) | 2 |
| [Delete (€29)](#suppression) | 1 |

## Other tools [#autres]

### `salesforce_describe_object` [#salesforce_describe_object]

**Salesforce: Describe Object** · read-only · idempotent

Describe a Salesforce object's fields, types, picklist values and which fields are required for creation. Essential before any write.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `object_type` | `string` | yes | SObject API name (e.g. "Contact", "Opportunity", "Project\_\_c"). |
| `fields_only` | `boolean` | no | Return a compact field list instead of the full metadata payload (default true). |

### `salesforce_get_account` [#salesforce_get_account]

**Salesforce: Get Account** · read-only · idempotent

Get a Salesforce account (company or organization) by ID, with all its fields.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `account_id` | `string` | yes | Salesforce Account ID. |

### `salesforce_get_campaign` [#salesforce_get_campaign]

**Salesforce: Get Campaign** · read-only · idempotent

Get a Salesforce campaign by ID, including its performance rollup fields.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `campaign_id` | `string` | yes | Salesforce Campaign ID. |

### `salesforce_get_opportunity` [#salesforce_get_opportunity]

**Salesforce: Get Opportunity** · read-only · idempotent

Get a Salesforce opportunity by ID, with all its fields.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `opportunity_id` | `string` | yes | Salesforce Opportunity ID. |

### `salesforce_get_org_limits` [#salesforce_get_org_limits]

**Salesforce: Get Org Limits** · read-only · idempotent

Get the org API limits and current consumption (DailyApiRequests, etc.). Check this before running heavy queries.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |

### `salesforce_get_record` [#salesforce_get_record]

**Salesforce: Get Record** · read-only · idempotent

Get any Salesforce record by object type and ID (works for standard and custom objects).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `object_type` | `string` | yes | SObject API name (e.g. "Contact", "Case", "Project\_\_c"). |
| `record_id` | `string` | yes | Salesforce record ID (15 or 18 characters). |
| `fields` | `string` | no | Comma-separated fields to return (default: all). |

### `salesforce_leads_by_source` [#salesforce_leads_by_source]

**Salesforce: Leads by Source** · read-only · idempotent

Aggregate leads by source and status - shows which acquisition channels produce leads that actually convert.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `created_from` | `string` | no | Earliest CreatedDate (YYYY-MM-DD). |

### `salesforce_list_accounts` [#salesforce_list_accounts]

**Salesforce: List Accounts** · read-only · idempotent

List Salesforce accounts (companies/organizations).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `limit` | `number` | no | Max number of accounts (1-2000). Default: `20`. |
| `offset` | `number` | no | Pagination offset. |

### `salesforce_list_campaigns` [#salesforce_list_campaigns]

**Salesforce: List Campaigns** · read-only · idempotent

List Salesforce marketing campaigns with cost and ROI fields - lets you compare CRM-recorded spend against ad platform spend.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `limit` | `number` | no | Max number of campaigns (1-2000). Default: `20`. |
| `offset` | `number` | no | Pagination offset. |
| `is_active` | `boolean` | no | Filter on IsActive. |

### `salesforce_list_cases` [#salesforce_list_cases]

**Salesforce: List Cases** · read-only · idempotent

List Salesforce support cases, newest first, with subject, status, priority, origin, account and contact; filterable by status and account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `limit` | `number` | no | Max number of cases (1-2000). Default: `20`. |
| `offset` | `number` | no | Pagination offset. |
| `status` | `string` | no | Filter on Status. |
| `account_id` | `string` | no | Filter to a given Account. |

### `salesforce_list_objects` [#salesforce_list_objects]

**Salesforce: List Objects** · read-only · idempotent

List all sObjects available in the org, including custom objects (\_\_c). Use this to discover what exists before querying.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `creatable_only` | `boolean` | no | Only return objects that can be created (useful before a write). |

### `salesforce_list_opportunities` [#salesforce_list_opportunities]

**Salesforce: List Opportunities** · read-only · idempotent

List Salesforce opportunities (deals). Filter by stage, open/closed status or close date to analyse the pipeline.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `limit` | `number` | no | Max number of opportunities (1-2000). Default: `20`. |
| `offset` | `number` | no | Pagination offset. |
| `stage` | `string` | no | Filter on StageName (exact API value). |
| `is_closed` | `boolean` | no | true = closed deals only, false = open pipeline only. |
| `is_won` | `boolean` | no | true = won deals only. |
| `close_date_from` | `string` | no | Earliest CloseDate (YYYY-MM-DD). |
| `close_date_to` | `string` | no | Latest CloseDate (YYYY-MM-DD). |
| `account_id` | `string` | no | Filter to a given Account. |

### `salesforce_list_tasks` [#salesforce_list_tasks]

**Salesforce: List Tasks** · read-only · idempotent

List Salesforce tasks (calls, emails, to-dos logged against records).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `limit` | `number` | no | Max number of tasks (1-2000). Default: `20`. |
| `offset` | `number` | no | Pagination offset. |
| `who_id` | `string` | no | Filter to a Contact or Lead ID. |
| `what_id` | `string` | no | Filter to a related record (Account, Opportunity...). |
| `open_only` | `boolean` | no | Only tasks that are not closed. |

### `salesforce_pipeline_summary` [#salesforce_pipeline_summary]

**Salesforce: Pipeline Summary** · read-only · idempotent

Aggregate the opportunity pipeline by stage (count and total amount). Answers "how much revenue is in play and where".

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `close_date_from` | `string` | no | Earliest CloseDate (YYYY-MM-DD). |
| `close_date_to` | `string` | no | Latest CloseDate (YYYY-MM-DD). |

### `salesforce_revenue_by_source` [#salesforce_revenue_by_source]

**Salesforce: Revenue by Source** · read-only · idempotent

Aggregate won revenue by LeadSource - the direct bridge between ad acquisition channels and closed revenue.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `close_date_from` | `string` | no | Earliest CloseDate (YYYY-MM-DD). |
| `close_date_to` | `string` | no | Latest CloseDate (YYYY-MM-DD). |
| `include_open` | `boolean` | no | Include open deals as well as won ones (default false = won only). |

### `salesforce_search` [#salesforce_search]

**Salesforce: Search** · read-only · idempotent

Global search across Salesforce objects using SOSL.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `query` | `string` | yes | Search term. |
| `objects` | `string` | no | Comma-separated objects to search (default: Contact, Account, Opportunity, Lead). |

## Create and change (€29) [#modification]

Served with the €29 plan.

### `salesforce_create_record` [#salesforce_create_record]

**Salesforce: Create Record** · create or change, €29 plan · creates an object on each call

Creates a Salesforce company (Account), opportunity (Opportunity) or campaign (Campaign), then reads it back. No person (contact, lead, user, person account). describe\_object gives the required fields. delete\_record deletes an opportunity or a campaign without members; a company is not deleted by this server.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `object_type` | `string` | yes | Account (company), Opportunity or Campaign. People are neither created nor updated through this server. Values: `"Account"`, `"Opportunity"`, `"Campaign"`. |
| `fields` | `object` | yes | The fields to set, by API name (Name, StageName, CloseDate, Amount, Custom\_\_c...). describe\_object gives the exact names. |

### `salesforce_update_record` [#salesforce_update_record]

**Salesforce: Update Record** · create or change, €29 plan · creates an object on each call

Updates a Salesforce company (Account), opportunity (Opportunity) or campaign (Campaign): reads the record before and after, refuses a person account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `object_type` | `string` | yes | Account (company), Opportunity or Campaign. People are neither created nor updated through this server. Values: `"Account"`, `"Opportunity"`, `"Campaign"`. |
| `record_id` | `string` | yes |   |
| `fields` | `object` | yes | The fields to set, by API name (Name, StageName, CloseDate, Amount, Custom\_\_c...). describe\_object gives the exact names. |

## Delete (€29) [#suppression]

Served with the €29 plan. A deletion targets one object at a time.

### `salesforce_delete_record` [#salesforce_delete_record]

**Salesforce: Delete Record** · delete, €29 plan, one object at a time · creates an object on each call

Deletes one Salesforce opportunity (Opportunity) or campaign (Campaign) without members: reads it before, deletes, then checks it can no longer be read. The record goes to the Salesforce Recycle Bin, where an administrator can restore it. One record per call. A company (Account) is not deleted by this server: Salesforce would also delete its contacts.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `instance_url` | `string` | no | Salesforce instance URL (e.g. https://na1.salesforce.com). |
| `object_type` | `string` | yes | Opportunity, or Campaign without members. Values: `"Opportunity"`, `"Campaign"`. |
| `record_id` | `string` | yes |   |
