# sf-intelligence — Salesforce org intelligence for AI agents

> sf-intelligence — Salesforce org intelligence for AI agents is an open-source MCP server for sales and crm. Offline read-only MCP server that maps one Salesforce org's metadata and impact. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://sfi.auditforce.cloud
- **Repository:** https://github.com/pranavnagrecha/salesforce-intelligence
- **MCP Registry name:** io.github.PranavNagrecha/sf-intelligence
- **Categories:** sales and CRM, developer tools
- **Listing updated:** 2026-11-16

## About

sf-intelligence answers from a local folder holding a snapshot of one org's metadata and a dependency graph, so it works offline and never writes to Salesforce. Every answer names the components behind it and lists what was not checked, for example reports or Lightning pages missing from the snapshot, rather than implying nothing is there.

It targets admin and developer questions: where a field is used, whether it can be deleted, what runs in what order when a record is saved, which Apex is unused and who can see or edit an object. The README includes a typo-tolerant resolver that asks a clarifying question when a name is ambiguous, and a built-in demo org for trying it without a Salesforce login.

By default the assistant sees 16 tools; further analyses sit behind a gateway tool. An optional live read-only mode is off until switched on. The vault location is set with the SFI_VAULT environment variable.

## Features

- **Field usage lookup:** Finds Apex, flows, layouts, rules and reports that reference a field.
- **Delete verdicts:** Gives safe, risky, blocking or review with reasons and what was not checked.
- **Save-order trace:** Lists triggers, validations, flows and approvals in run order.
- **Dead Apex detection:** Finds classes and triggers nothing calls, with confidence tiers.
- **Permission analysis:** Explains who can see or edit via profiles and permission sets.
- **Built-in demo org:** Lets you try it with no Salesforce login.

## Good for

- Check what breaks before deleting a Salesforce field
- Trace what runs when a record is saved
- Find unused Apex before a cleanup
- Understand why a user cannot see a record

## Install

### Claude Code (Terminal)

```sh
claude mcp add sf-intelligence --env SFI_VAULT='<SFI_VAULT>' -- npx -y sf-intelligence
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "sf-intelligence": {
      "command": "npx",
      "args": [
        "-y",
        "sf-intelligence"
      ],
      "env": {
        "SFI_VAULT": "<SFI_VAULT>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sf-intelligence": {
      "command": "npx",
      "args": [
        "-y",
        "sf-intelligence"
      ],
      "env": {
        "SFI_VAULT": "<SFI_VAULT>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "sf-intelligence": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "sf-intelligence"
      ],
      "env": {
        "SFI_VAULT": "<SFI_VAULT>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "sf-intelligence": {
      "command": "npx",
      "args": [
        "-y",
        "sf-intelligence"
      ],
      "env": {
        "SFI_VAULT": "<SFI_VAULT>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "sf-intelligence": {
      "command": "npx",
      "args": [
        "-y",
        "sf-intelligence"
      ],
      "env": {
        "SFI_VAULT": "<SFI_VAULT>"
      }
    }
  }
}
```

## Tools

- `sfi.resolve`: Resolves messy phrasing to a component
- `sfi.search_components`: Searches org components
- `sfi.get_component`: Fetches one component
- `sfi.health_check`: Checks the server's state
- `sfi.list_analyses`: Lists available analyses
- `sfi.describe_analysis`: Describes an analysis
- `sfi.run_analysis`: Gateway tool that runs other analyses
- `sfi.live_consent`: Handles consent for the optional live read-only mode

## FAQ

### Does it change my org?

No, it is read-only and runs on your computer.

### Does it need a network connection?

Answers are served offline from a local vault; the live read-only plane is optional and off by default.

### How do I try it without an org?

Run the demo with npx and sf-intelligence demo.

### What must I configure?

SFI_VAULT, the absolute path to your org-kb folder.

### Is sf-intelligence — Salesforce org intelligence for AI agents free?

Yes. sf-intelligence — Salesforce org intelligence for AI agents is open source, so you can use and self-host it for free.

### How do I add sf-intelligence — Salesforce org intelligence for AI agents to Claude Code?

Run this command in your terminal: claude mcp add sf-intelligence --env SFI_VAULT='<SFI_VAULT>' -- npx -y sf-intelligence

### What are the best alternatives to sf-intelligence — Salesforce org intelligence for AI agents?

The closest alternatives to sf-intelligence — Salesforce org intelligence for AI agents are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/sf-intelligence-salesforce-org-intelligence-for-ai-agents
