Available Tools

The PingRep MCP server exposes four tools. Three are public (no API key needed) and one requires authentication. AI clients can only access profiles where is_public and mcp_discoverable are both enabled.

get_profile

Look up a professional profile by ID or slug. Returns the full public profile including name, title, company, bio, and social links.

Auth: Public

Parameters

profileIdstringRequired

Profile ID (UUID) or URL slug to look up.

ask_ai_rep

Ask an AI Representative a question about the profile owner. The AI Rep responds based on the professional's identity, experience, and expertise.

Auth: Public

Parameters

profileIdstringRequired

Profile ID or slug of the person whose AI Rep you want to ask.

questionstringRequired

Your question for the AI Representative. Maximum 500 characters.

Question Length

Questions are limited to 500 characters. Keep them focused for the best responses. The AI Rep draws on the profile owner's professional context to generate relevant answers.

search_profiles

Search the PingRep professional directory. Filter by keyword, role, location, or any combination.

Auth: Public

Parameters

querystringOptional

Free-text search query.

rolestringOptional

Filter by professional role or title.

locationstringOptional

Filter by geographic location.

Search Tips

You can combine all three parameters for precise results. Omit parameters you do not need. For example, searching with only location: "Dubai" returns all discoverable professionals in Dubai regardless of role.

save_contact

Save a contact to your PingRep contact list. This is the only tool that requires authentication.

Auth: API Key Required

Parameters

profileIdstringRequired

Profile ID of the person to save as a contact.

namestringRequired

Name of the contact.

emailstringRequired

Email address of the contact.

phonestringOptional

Phone number of the contact.

notesstringOptional

Notes about this contact. Maximum 500 characters.

Authentication Required

The save_contact tool only works when the MCP server is configured with a valid KEYNODECARD_API_KEY. Without it, the tool will return an authentication error.

Privacy and Discoverability

MCP clients can only interact with profiles that have both settings enabled:

is_public: The profile is visible to anyone
mcp_discoverable: The profile owner has opted in to AI tool discovery

Profile owners control these settings from their PingRep dashboard. If a profile is not discoverable, MCP tools will not return it in search results or allow AI Rep queries.