ProvenTools MCP server
✓ VerifiedProvides read-only access to business ideas, evidence, build prompts, and validation reports via an MCP server.
Also known as proventools/agent-clients, agent-clients, @proventools/mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0-beta.3
- Last commit
- Aug 11, 2026
- License
- MIT
What is ProvenTools MCP?
ProvenTools provides read-only access to business ideas, evidence, build prompts, and validation reports via an MCP server.
Summary generated from the project's README
About ProvenTools MCP server
ProvenTools provides a read-only interface for accessing business ideas, validation reports, build prompts, and supporting evidence. Developers can integrate this data into their local workflows using the @proventools/mcp package, which operates as a local stdio MCP server. This setup allows AI agents and developer tools to pull specific business intelligence directly into their context.
To use this server, you must have an eligible ProvenTools account and a valid API key. While the client software is free to install via npm, the underlying datasets and content are hosted externally and require authentication. The server is designed to work with Node.js 22.14 or newer and functions as a bridge between your local agentic environment and the ProvenTools application ecosystem.
Written from the project's README. Every use case is checked against a quote from it.
How to install ProvenTools MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ProvenTools MCP in Claude Code
$ claude mcp add --env 'PROVENTOOLS_API_KEY=<YOUR_PROVENTOOLS_API_KEY>' agent-clients -- npx -y @proventools/mcpInstall ProvenTools MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agent-clients": {
"command": "npx",
"args": [
"-y",
"@proventools/mcp"
],
"env": {
"PROVENTOOLS_API_KEY": "<YOUR_PROVENTOOLS_API_KEY>"
}
}
}
}Install ProvenTools MCP in VS Code
.vscode/mcp.json
{
"servers": {
"agent-clients": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@proventools/mcp"
],
"env": {
"PROVENTOOLS_API_KEY": "<YOUR_PROVENTOOLS_API_KEY>"
}
}
}
}Install ProvenTools MCP in VS Code CLI
$ code --add-mcp '{"name":"agent-clients","type":"stdio","command":"npx","args":["-y","@proventools/mcp"],"env":{"PROVENTOOLS_API_KEY":"<YOUR_PROVENTOOLS_API_KEY>"}}'Install ProvenTools MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"agent-clients": {
"command": "npx",
"args": [
"-y",
"@proventools/mcp"
],
"env": {
"PROVENTOOLS_API_KEY": "<YOUR_PROVENTOOLS_API_KEY>"
}
}
}
}Install ProvenTools MCP in Codex
$ codex mcp add agent-clients --env 'PROVENTOOLS_API_KEY=<YOUR_PROVENTOOLS_API_KEY>' -- npx -y @proventools/mcpInstall ProvenTools MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.agent-clients] command = "npx" args = ["-y", "@proventools/mcp"] [mcp_servers.agent-clients.env] PROVENTOOLS_API_KEY = "<YOUR_PROVENTOOLS_API_KEY>"
Install ProvenTools MCP in Gemini CLI
$ gemini mcp add -s user -e 'PROVENTOOLS_API_KEY=<YOUR_PROVENTOOLS_API_KEY>' agent-clients npx -- -y @proventools/mcpInstall ProvenTools MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agent-clients": {
"command": "npx",
"args": [
"-y",
"@proventools/mcp"
],
"env": {
"PROVENTOOLS_API_KEY": "<YOUR_PROVENTOOLS_API_KEY>"
}
}
}
}Configuration
PROVENTOOLS_API_KEYSecretOptional ProvenTools API key from the dashboard. Keep it in the client's secret store; never commit it to a project file.
| Name | Description | |
|---|---|---|
| PROVENTOOLS_API_KEY | Optional ProvenTools API key from the dashboard. Keep it in the client's secret store; never commit it to a project file. | Secret |
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableproventools/agent-clients is public and reachablegithub.com/proventools/agent-clients ↗Pass
- Package names this repository as its source@proventools/mcp names proventools/agent-clients as sourcenpmjs.com/package/@proventools/mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @proventools/mcpnpmjs.com/package/@proventools/mcp/v/0.1.0-beta.3#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-11github.com/proventools/agent-clients ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @proventools/mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubProvenTools agent clients
Official open-source clients for connecting developer tools and local agents to ProvenTools.
proventools: read-only CLI plus a bundled agent skill@proventools/mcp: read-only local stdio MCP server
The hosted ProvenTools application, API implementation, datasets, content, and customer systems are not part of this repository.
Status
The CLI and read-only local MCP betas are published on npm and GitHub.
The repository also contains metadata prepared for the official MCP Registry, Claude's community plugin marketplace, and the Cursor Directory. Installing the clients is free. Access to ProvenTools data still requires an eligible ProvenTools account and API key.
Directory publication is approval-gated and is not performed by the test or npm staging workflows.
Verify
Use Node.js 22.14 or newer:
npm test
The tests build the real npm tarballs, enforce exact contents, scan for common credential and personal-data patterns, install both packages offline, and run their executable smoke tests.
Security
Never include a ProvenTools API key in an issue, prompt, command argument,
checked-in configuration, or log. Report vulnerabilities privately through
https://www.proventools.net/contact.
License
The client code, tests, documentation, and bundled skill in this repository are licensed under MIT. The license does not grant rights to the ProvenTools API, datasets, content, trademarks, paid features, or service access.
ProvenTools MCP questions
How do I add ProvenTools MCP to Claude Code?
Run claude mcp add --env 'PROVENTOOLS_API_KEY=<YOUR_PROVENTOOLS_API_KEY>' agent-clients -- npx -y @proventools/mcp in your terminal. Add --scope user to make it available in every project.
How do I add ProvenTools MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I access ProvenTools data?
Accessing the data requires an eligible ProvenTools account and an API key.
Is there a cost to install the clients?
Yes, installing the ProvenTools clients is free.
What version of Node.js is required?
You must use Node.js version 22.14 or newer.