ProvenTools

Name: ProvenTools
Author: proventools

Local

github.com/proventoolsBusiness & Marketing1Updated 11w ago

Repository

About ProvenTools

ProvenTools provides read-only clients for accessing business ideas, evidence, build prompts, and validation reports. It includes a CLI, an agent skill, and a local MCP server; access to the data requires an eligible ProvenTools account and API key.

Key features

01Read-only CLI
02Bundled agent skill
03Local stdio MCP server

Use cases

01Access ProvenTools data from the command line
02Use ProvenTools from a local agent
03Connect to ProvenTools through an MCP client

MCP support

It provides a read-only local stdio MCP server for MCP clients to connect to ProvenTools.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "proventools-proventools": {
      "command": "npx",
      "args": [
        "-y",
        "@proventools/mcp"
      ],
      "env": {
        "PROVENTOOLS_API_KEY": "<PROVENTOOLS_API_KEY>"
      }
    }
  }
}

Run commandnpx -y @proventools/mcp

Environment variables to set

PROVENTOOLS_API_KEYSecretOptional ProvenTools API key from the dashboard. Keep it in the client's secret store; never commit it to a project file.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@proventools/mcp0.1.0-beta.3stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
page	integer	No	Results page.
query	string	No	Words to search for.
category	string	No	Exact category name.
difficulty	string	No	Easy, Medium, or Hard.

Details

From the project README

ProvenTools 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.