MCP Server Installation
The PingRep MCP (Model Context Protocol) server connects AI tools like Claude Desktop to the PingRep platform. Once installed, AI assistants can look up professional profiles, ask AI Representatives questions, search the directory, and save contacts on your behalf.
Prerequisites
- Node.js 18 or later
- A PingRep API key (get one from your dashboard)
- An MCP-compatible AI tool (Claude Desktop, or any MCP client)
Install via NPX
The fastest way to get started. No global install required.
This downloads and runs the MCP server. To install it globally:
Environment Variables
The MCP server requires two environment variables:
KEYNODECARD_API_KEYstringRequiredYour PingRep API key. Required for authenticated operations like saving contacts.
KEYNODECARD_BASE_URLstringRequiredThe PingRep app URL. Set to https://app.pingrep.com for production.
Configure for Claude Desktop
Add the following to your Claude Desktop configuration file.
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
Verify the Installation
After saving your configuration, restart Claude Desktop. You should see the PingRep tools available in the tools menu (the hammer icon).
Test with a simple query:
Public vs Authenticated Tools
Some tools like get_profile, ask_ai_rep, and search_profiles work without authentication. The save_contact tool requires a valid API key.
API Key Security
Your API key grants access to your PingRep account. Never share your Claude Desktop config file or commit it to version control. Treat the API key like a password.