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 URL | https://www.genuinein.com/api/v1/mcp/stream |
|---|---|
| Transport | Streamable HTTP |
| Authentication | OAuth 2.0 authorization code with PKCE (S256) and dynamic client registration. No client ID or secret is needed. |
| Discovery | https://www.genuinein.com/.well-known/oauth-protected-resource |
Setup
Claude (web and desktop)
- Open Settings → Connectors and choose Add custom connector, or add ProfileID from the Connectors Directory.
- Enter the name
ProfileIDand the server URLhttps://www.genuinein.com/api/v1/mcp/stream. Leave the OAuth client fields empty. - Select Connect, sign in to GenuineIN, review the permissions, and select Approve.
- 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:
| Scope | Grants |
|---|---|
profile:read | Basic profile information: name, title, photo, and summary. |
full:read | All 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.
| Tool | Title |
|---|---|
get_profile | Get full career profile |
get_info | Get career profile section: basic info |
get_education | Get career profile section: education |
get_experience | Get career profile section: experience |
get_skills | Get career profile section: skills |
get_certifications | Get career profile section: certifications |
get_projects | Get career profile section: projects |
get_training | Get career profile section: training |
get_internships | Get career profile section: internships |
get_volunteering | Get career profile section: volunteering |
get_publications | Get career profile section: publications |
get_patents | Get career profile section: patents |
get_memberships | Get career profile section: memberships |
get_recognition | Get career profile section: recognition |
get_events | Get career profile section: events |
get_test_scores | Get career profile section: test scores |
get_courses | Get career profile section: courses |
get_sports | Get career profile section: sports |
get_research | Get career profile section: research |
get_languages | Get career profile section: languages |
get_attributes | Get career profile section: attributes |
get_industry_focus | Get career profile section: industry focus |
get_machines_tools | Get career profile section: machines tools |
get_social_profiles | Get career profile section: social profiles |
get_recommendations | Get career profile section: recommendations |
get_credentials | Get career profile section: credentials |
get_portfolio | Get career profile section: portfolio |
get_career_objective | Get career profile section: career objective |
get_interests | Get career profile section: interests |
get_extra_curricular | Get career profile section: extra curricular |
get_articles | Get career profile section: articles |
get_news_media | Get career profile section: news media |
get_community | Get career profile section: community |
get_endorsements | Get career profile section: endorsements |
get_competencies | Get career profile section: competencies |
get_social_updates | Get career profile section: social updates |
get_youtube_channels | Get career profile section: youtube channels |
get_book_reading | Get career profile section: book reading |
get_intent | Get 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
| Message | What 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 error | Remove the connector, add it again, and complete sign-in in the same browser. |
Support
Email support@genuinein.com or visit the support desk.