Local MCP · betav0.1.0-beta.2

Put the idea libraryinside your agent.

The official ProvenTools MCP server gives Codex, Claude Code, Cursor and other local agents read-only access to ideas, evidence and build prompts.

Create an API keyView source on GitHub

Node.js 22.14+ · zero runtime dependencies · exact beta version pinned

proventools / stdio
connected
transportlocal stdio
accessread-only beta
credits0 for every exposed tool

sample request

> Find developer-tool ideas with strong evidence and compare the best two.

Three-step setup

Authenticate once. Choose your client.

The CLI saves your key in a private owner-only file. The MCP server reuses it, so the secret never appears in your MCP configuration.

Never paste an API key into an MCP command, checked-in JSON file, prompt or log.
  1. 01

    Install the CLI

    This provides the secure login flow used by both local clients.

    terminal
    npm install --global proventools@0.1.0-beta.1
  2. 02

    Save your API key

    The key is entered at a hidden prompt, validated, then stored with owner-only permissions.

    terminal
    proventools login
  3. 03

    Add ProvenTools to your MCP client

    Select your client. Every command pins the reviewed beta release.

    Register the local stdio server in Codex.

    terminal
    codex mcp add proventools -- npx --yes @proventools/mcp@0.1.0-beta.2
    Verifycodex mcp get proventools --json

Twelve read-only tools

Research without breaking your flow.

Search and inspect

01

Search the curated library, open complete idea records and read stored evidence snapshots.

search_ideasget_ideaget_idea_evidence

Build handoff

02

Pull an agent-ready build prompt or inspect the latest monthly drop without leaving your editor.

get_build_promptwhats_new

Decision support

03

Ask for recommendations, shortlists, comparisons and plain-language ProvenScore explanations.

recommend_ideasshortlist_ideasdiscover_ideascompare_ideasexplain_idea_score

Account reads

04

Check existing validation reports and your current Live credit balance as read-only data.

get_validation_reportget_credit_balance

Security boundary

Designed to be boring around secrets.

The local process uses Node.js built-ins only. It talks to approved ProvenTools origins, exposes read-only tools and keeps protocol output separate from diagnostics.

  • Every tool in this beta costs 0 credits.
  • The server cannot start paid jobs, submit validations or spend credits.
  • Your API key stays out of MCP configuration and command history.
  • Requests reject redirects and untrusted API origins.
  • Request size, response size and concurrent calls are bounded.

Prefer direct terminal commands?

The ProvenTools CLI uses the same secure login and read-only API access.

Open the CLI guide