Pipedrive Reports (BYOK) — connector documentation
- MCP endpoint:
https://byok-pipedrive-reports.connectorbay.com/mcp - REST API:
POST https://byok-pipedrive-reports.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec athttps://byok-pipedrive-reports.connectorbay.com/openapi.json - Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
- Authentication: your own Pipedrive Reports personal API token, sent in the
X-Upstream-Keyheader of every request (never stored, logged or cached) - Health:
https://byok-pipedrive-reports.connectorbay.com/health· Tool schemas:https://byok-pipedrive-reports.connectorbay.com/tools.json - Publisher: Unify Dynamics LLC · connectorbay.com/byok-pipedrive-reports · agent@connectorbay.com
What Pipedrive Reports (BYOK) is for
Pipedrive Reports (BYOK) lets an AI assistant read your own Pipedrive Reports data through the Pipedrive Reports API with a key you supply (personal API token). Read-only: 5 tools (get_deals_summary, get_pipeline_conversion_statistics, get_pipeline_movement_statistics, find_goals, get_goal_results). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.pipedrive.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Pipedrive Reports. Pipedrive Reports and its logos are trademarks of their owners and are used only to say which service the connector works with.
Ask your assistant things like:
- "What is the total value of our open deals in Pipedrive?"
- "What is the win rate of Pipedrive pipeline 1 in October?"
- "How many deals did Pipedrive pipeline 1 win and lose last month?"
- "What sales goals are active in Pipedrive?"
- "How far along is Pipedrive goal 9b1a2c3d this quarter?"
What it does
get_deals_summary: Get the number and total value of deals (plain and weighted) filtered by status, pipeline, stage or user. Totals only, no deal details.get_pipeline_conversion_statistics: Get stage-to-stage conversion rates and the won and lost conversion rates of a pipeline for a period.get_pipeline_movement_statistics: Get how deals moved through a pipeline in a period: new, still open, won and lost deal counts and values, movements between stages and average age.find_goals: Find sales goals with title, type, assignee, interval, period and target. By default only the token user's goals; filters widen it.get_goal_results: Get the progress made on one goal within a period, with the goal's definition.
BYOK key
You bring your own Pipedrive Reports personal API token (https://support.pipedrive.com/en/article/how-can-i-find-my-personal-api-key). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.pipedrive.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.
Data sources
- https://developers.pipedrive.com/docs/api/v1 (the API this connector calls, with a BYOK key)
Live from the Pipedrive Reports API (api.pipedrive.com) with a BYOK key; documentation: https://developers.pipedrive.com/docs/api/v1. Endpoints checked against that documentation on 2026-10-16.
What it is not
Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Pipedrive Reports. Pipedrive Reports and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Pipedrive Reports account.
Built for: Worldwide. Languages: English.