MCP

​

Overview

The Finch MCP Server makes it simple to integrate Large Language Models (LLMs) with the Finch API using natural language. Rather than writing custom API calls, you can describe your intent, and the LLM will handle the rest by issuing calls to the Finch API to get the information you need or take action on your behalf.

The Finch MCP Server exposes structured tools to LLMs, making it possible to use Finch’s API without understanding its full surface area. This unlocks powerful, intuitive workflows for developers, finance teams, support agents, and more.

MCP stands for Model Context Protocol, a mechanism that defines how LLMs can safely interact with external APIs and tools.

​

💾 Installation

Install the MCP Server via npm:

npm install @tryfinch/finch-api-mcp

​

⚙️ LLM Configuration

To connect the Finch MCP Server to an MCP Client, you will need to add the appropriate configuration to your client. Below is an example of what that may look like.

{
  "mcpServers": {
    "finch_api": {
      "command": "npx",
      "args": ["-y", "@tryfinch/finch-api-mcp"],
      "env": {
        "FINCH_ACCESS_TOKEN": "<a specific connection's access token>"
      }
    }
  }
}

💡 Replace <a specific connection's access token> with a valid Finch API access token for the connection you want the LLM to access.

🔐 Security Note: Use a token scoped to only the data required for your use case. Read-only tokens are recommended for most applications. Depending on your use case, and due to the sensitive nature of employment data, take extra caution when deciding what LLMs you choose to share your data with and the usage policies of the LLM provider. Finch’s general recommendation is to use a self-hosted LLM for usage with the Finch MCP Server.

​

Example Use Cases

​

🧑‍💼 Employee Directory Lookup

Sample Prompt:

Find all employees in the engineering department who started after January 1st, 2023.

​

💼 Job Titles & Compensation

Sample Prompt:

What are the current titles and base salaries of everyone on the sales team?

​

📊 Workforce Demographics

Sample Prompt:

How many employees are full-time vs part-time across all locations?

​

Need Help?

If you run into issues or have questions, reach out to us at support@tryfinch.com.