logo

Developer documentation

ProfileID MCP connector

ProfileID connects AI assistants such as Claude and ChatGPT to your verified GenuineIN career profile. After you sign in and approve access, the assistant can read your education, experience, skills, certifications, and other profile sections. ProfileID is read-only and never changes your profile.

Requirements

  • A free GenuineIN account with a career profile. Create one at genuinein.com.
  • An MCP client that supports remote servers with OAuth, such as Claude, Claude Code, or ChatGPT.

Server details

MCP server URLhttps://www.genuinein.com/api/v1/mcp/stream
TransportStreamable HTTP
AuthenticationOAuth 2.0 authorization code with PKCE (S256) and dynamic client registration. No client ID or secret is needed.
Discoveryhttps://www.genuinein.com/.well-known/oauth-protected-resource

Setup

Claude (web and desktop)

  1. Open Settings → Connectors and choose Add custom connector, or add ProfileID from the Connectors Directory.
  2. Enter the name ProfileID and the server URL https://www.genuinein.com/api/v1/mcp/stream. Leave the OAuth client fields empty.
  3. Select Connect, sign in to GenuineIN, review the permissions, and select Approve.
  4. In a chat, enable ProfileID from the tools menu and ask about your profile.

Claude Code

claude mcp add --transport http profileid https://www.genuinein.com/api/v1/mcp/stream

Then run /mcp, choose profileid, select Authenticate, and approve access in the browser.

ChatGPT

Add ProfileID from the ChatGPT apps directory, or in developer mode create a connector with the server URL above and OAuth authentication. Approve access when prompted.

Other MCP clients

Any client that supports remote Streamable HTTP servers with OAuth can connect using the server URL. For example, in VS Code:

{ "servers": { "profileid": { "type": "http", "url": "https://www.genuinein.com/api/v1/mcp/stream" } } }

Permissions

The consent screen shows the client's name and the access it requests. ProfileID uses two read-only scopes:

ScopeGrants
profile:readBasic profile information: name, title, photo, and summary.
full:readAll profile sections, such as education, experience, skills, certifications, projects, and achievements.

Contact details (email address, phone number, and postal address) are never returned to AI assistants. Access is limited to your own profile, and to other profiles only where their owner has shared them with you.

Tools

All 39 tools are read-only. Each takes one optional argument, gpin, a 10-character GenuineIN profile ID. Omit it to read your own profile.

ToolTitle
get_profileGet full career profile
get_infoGet career profile section: basic info
get_educationGet career profile section: education
get_experienceGet career profile section: experience
get_skillsGet career profile section: skills
get_certificationsGet career profile section: certifications
get_projectsGet career profile section: projects
get_trainingGet career profile section: training
get_internshipsGet career profile section: internships
get_volunteeringGet career profile section: volunteering
get_publicationsGet career profile section: publications
get_patentsGet career profile section: patents
get_membershipsGet career profile section: memberships
get_recognitionGet career profile section: recognition
get_eventsGet career profile section: events
get_test_scoresGet career profile section: test scores
get_coursesGet career profile section: courses
get_sportsGet career profile section: sports
get_researchGet career profile section: research
get_languagesGet career profile section: languages
get_attributesGet career profile section: attributes
get_industry_focusGet career profile section: industry focus
get_machines_toolsGet career profile section: machines tools
get_social_profilesGet career profile section: social profiles
get_recommendationsGet career profile section: recommendations
get_credentialsGet career profile section: credentials
get_portfolioGet career profile section: portfolio
get_career_objectiveGet career profile section: career objective
get_interestsGet career profile section: interests
get_extra_curricularGet career profile section: extra curricular
get_articlesGet career profile section: articles
get_news_mediaGet career profile section: news media
get_communityGet career profile section: community
get_endorsementsGet career profile section: endorsements
get_competenciesGet career profile section: competencies
get_social_updatesGet career profile section: social updates
get_youtube_channelsGet career profile section: youtube channels
get_book_readingGet career profile section: book reading
get_intentGet career profile section: intent

Example prompts

  • "Summarize my verified GenuineIN career profile."
  • "List the verified credentials in my GenuineIN profile and their issuers."
  • "Draft a résumé for a senior data analyst role using my GenuineIN experience and skills."
  • "Prepare interview questions based on the projects in my GenuineIN profile."

Data handling

  • ProfileID reads profile data only when the assistant calls a tool. It does not write, delete, or change any data.
  • Responses exclude contact details and internal identifiers.
  • Access tokens expire after one hour and refresh tokens after 30 days. GenuineIN stores only token hashes, the granted scopes, and an audit record of each connection.
  • GenuineIN does not receive or store your conversations with the assistant.
  • Details are in the Privacy Policy, under "CareerMCP and AI Assistant Integrations", and the Terms of Use.

Disconnect and revoke access

  • In your assistant, disconnect or remove the ProfileID connector.
  • In GenuineIN, revoke the connection from Settings → Career Data API. Revoked tokens stop working immediately.

Troubleshooting

MessageWhat to do
"This connection does not include the '…' section."Disconnect ProfileID, reconnect, and approve access to all profile sections.
"Profile not found."The GPIN is incorrect or the profile is not shared with you. Omit gpin to read your own profile.
"Profile data temporarily unavailable."Your profile is being prepared. Try again in a few seconds.
Sign-in loop or authorization errorRemove the connector, add it again, and complete sign-in in the same browser.

Support

Email support@genuinein.com or visit the support desk.