Skip to main content

Documentation / MCP setup

Connect KnownIn to the tools where you work.

Connect one remote Model Context Protocol server and let Claude, ChatGPT, Cursor, or any compatible client use the same living professional profile.

4

supported clients

62

profile tools

1

source of truth

Four small steps

From zero to connected context.

Create an account

Sign up for KnownIn and tell the chat a little about yourself. The MCP server reads from this same living profile.

Generate an API key

Open Settings → API keys, give the key a label such as "Claude Desktop," and copy it. It is shown once.

Paste the client config

Choose your client below and follow the step-by-step guide to connect it to KnownIn.

Paste the main prompt

Open a fresh chat and paste the main prompt below. It verifies the connection and covers KnownIn tools, job tracking, resumes, and LinkedIn networking.

Generate your key from Settings → API keys. Keys are stored as one-way hashes, shown once, and can be revoked independently at any time.

Client setup

Choose your surface.

Each client handles remote MCP connections differently. Pick yours for exact, step-by-step configuration.

Selected client

Claude Desktop App

  1. 1Open Claude Desktop → Settings → Developer → Edit Config. This opens the config file in your default editor (or opens its containing folder — open the file yourself if so).
  2. 2If Claude didn't open it directly, the file lives at: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json
  3. 3Paste the config on the right into the file. If it already has other servers under "mcpServers", add "knownin" as a new entry alongside them instead of replacing the file.
  4. 4Claude Desktop only talks to local (stdio) servers, so this config launches mcp-remote — a small official bridge that connects it to KnownIn's remote server over HTTP.
  5. 5Replace YOUR_API_KEY — in the env block, not the args — with the key you generated in Settings → API keys.
  6. 6Save the file, then fully quit Claude Desktop (not just close the window) and reopen it.
  7. 7Start a new chat and ask "What MCP tools do you have access to?" — you should see the KnownIn tools listed.
claude_desktop_config.json
Paste into claude_desktop_config.json

Once connected, copy the main prompt to set up your complete workflow.

Tool catalogue

All 62 tools, one identity.

Every connected client receives the same toolkit. Add and update operations are idempotent where appropriate, so assistants can act without creating accidental duplicates.

Read3 tools
get_full_profile

Read the complete profile — fields, skills, experience, projects, education, certifications, and custom sections.

list_recent_changes

Read recent recorded changes to the professional profile.

score_job_fit

Quickly screen a job description against existing profile skills without hosted AI.

Profile & card3 tools
apply_profile_changes

Safely batch multiple profile and skill changes into one transaction.

update_profile

Update top-level fields: name, headline, bio, contact info, any number of labeled links, avatar photo URL.

update_card_settings

Turn the public shareable card on/off and set its link (www.knownin.com/c/{slug}).

Skills3 tools
add_skill

Add a skill with an explicit verification status. Only verified skills are eligible for resumes.

update_skill

Update a skill's metadata or verification status; never promote a skill without profile evidence.

delete_skill

Delete a skill by id.

Experience3 tools
add_experience

Add a work experience entry. Skips creation if the same company + role already exists — use update instead.

update_experience

Update fields on an existing experience by id.

delete_experience

Delete an experience entry by id.

Projects3 tools
add_project

Add a project with any number of labeled links. Skips creation if one with the same name already exists — use update instead.

update_project

Update an existing project, including its complete labeled link list, by id.

delete_project

Delete a project by id.

Education3 tools
add_education

Add an education entry.

update_education

Update fields on an existing education entry by id.

delete_education

Delete an education entry by id.

Certifications3 tools
add_certification

Add a certification.

update_certification

Update fields on an existing certification by id.

delete_certification

Delete a certification by id.

Custom sections3 tools
list_sections

List AI-named custom sections — anything that doesn't fit skills/experience/projects/education/certifications (e.g. Languages, Awards & Honors).

add_to_section

Add one or more non-empty items to a section by title. Finds-or-creates — reuses an existing title so items merge instead of duplicating. Verify with list_sections after bulk writes.

remove_from_section

Remove one item from a section by its exact title and item text. Deletes the section if it becomes empty.

Resumes7 tools
list_resume_versions

Read compact resume choices and Main preferences; reuse unchanged data with revision/ifNoneMatch.

get_resume_version

Get one resume version by id.

save_resume_version

Save a manual/profile-based resume variant as an overlay on the base profile. This does not run AI matching or consume the hosted tailoring allowance; use tailor_resume for a specific job description and fit report.

tailor_resume

Build a grounded profile-overlay resume and fit report from a real JD; the connected assistant performs matching. Each complete job pack uses 5 shared AI-capacity units, like dashboard tailoring. Default to verified skills only. Explicit learning-aware mode uses Technical Skills, Practices, or Platforms for visible skills and stores gap metadata separately; gaps never become experience evidence.

get_resume_pdf

Return the exact AI-uploaded PDF artifact for a resume version, including its SHA-256 digest and a 15-minute download link.

upload_resume_pdf

Save exact AI-generated PDF bytes as the canonical artifact for a resume version; MCP and dashboard downloads reuse that same file.

delete_resume_version

Delete a resume version by id.

Resume templates4 tools
list_resume_templates

List all available resume templates — built-in KnownIn templates and any custom templates you have saved.

get_resume_template_spec

Get the full spec for a template: a machine-readable JSON layout and a natural-language description precise enough for PDF generation.

save_resume_template

Save a named custom resume template (colors, fonts, layout, section order) to your KnownIn account. Omit id to create; pass id to update.

delete_resume_template

Delete a custom resume template by id. Built-in templates cannot be deleted.

Job applications12 tools
list_application_answers

Read revision-cached private answers with ifNoneMatch; only Always disclose answers are included.

save_application_answer

Save any exact application question and answer with a user-controlled disclosure policy.

update_application_answer

Update one private application answer.

delete_application_answer

Delete one private application answer after confirmation.

get_application_answers

Compatibility alias for listing private application answers.

update_application_answers

Compatibility tool for the original fixed answer fields; use save_application_answer for new questions.

resolve_application_question

Match any application question to the answer bank, then stop for missing, ambiguous, blocked, or confirmation-required answers.

list_applications

Search compact saved jobs/revisions; verify ids in batches and request actor/reason history explicitly.

record_application

Save a Planned job or applications[] batch; submitted jobs require explicit confirmation, source and evidence. Stable keys make retries safe.

update_application

Update an application's stage, linked resume version or tracking fields and return the persisted record with its revision. Updates need expectedRevision and a stable idempotencyKey; stage changes need changeReason and submission evidence. Planned clears active confirmation fields.

bulk_update_applications

Save up to 100 independent application patches with revisions, retry keys and the same evidence rules; returns individual records or failures.

delete_application

Delete an application by id.

Job platforms3 tools
list_job_platforms

List registered job platforms (e.g. LinkedIn, Naukri) — used to auto-detect platform from a job URL.

add_job_platform

Register a job platform by name and base URL/hostname.

delete_job_platform

Delete a registered job platform by id.

Networking8 tools
search_contacts

Search saved networking contacts with compact paginated results.

upsert_contacts

Save or refresh sourced contacts, deduplicating LinkedIn profile URLs without merging namesakes.

save_hiring_evidence

Attach dated hiring evidence and reported opening status to a contact or conversation.

save_networking_thread

Save one conversation or threads[] batch with revisions and retry keys; manage next action and follow-up date; save specific openings in Applications as Planned first, then link the job for Applied via navigation. No scheduled inbox checks.

link_contact_to_application

Link a conversation to an existing job without changing application status.

save_outreach_draft

Save one LinkedIn draft or drafts[] batch with revisions/retry keys and individual results. Drafting never confirms a send or application.

record_outreach_event

Record confirmed sends, replies, connection changes, or notes with preserved message snapshots.

get_networking_context

Read compact contact, latest usable draft, linked job and relevant evidence; contactIds verifies batches. History/full detail/resume catalogue are opt-in.

Company sources4 tools
get_company_sources

Read the saved company career-board watchlist, with conditional revision reads.

upsert_company_sources

Save or refresh company career-board sources in a batch.

set_company_source_enabled

Enable or disable a saved company source.

delete_company_source

Delete a saved company source after confirmation.

Job workflow

Your assistant prepares. KnownIn keeps the context.

In a browser-capable ChatGPT session, one request can span both systems: ChatGPT searches and navigates; KnownIn supplies verified career facts, creates the tailored resume, and remembers the outcome.

01ChatGPT

Search

Find roles across the web or signed-in job portals.

02KnownIn

Save Planned

Read the real JD and save its URL, requirements and source links before applying.

03KnownIn

Match + tailor

Compare verified profile facts and generate the right PDF.

04ChatGPT

Fill + attach

Complete supported form steps with approved information.

05KnownIn

Track

Update the same job to Applied only after confirmed submission.

You control submission and outreach. ChatGPT may pause for login, CAPTCHA, missing answers, or final confirmation. KnownIn never marks a job applied without a confirmed portal success signal.

Main prompt

Ask normally. Start further ahead.

Paste one main prompt into your connected assistant. It explains the complete KnownIn toolset and how researched jobs, resumes, applications, and LinkedIn conversations stay connected.

One prompt for your complete workspace

Paste it once in your connected AI tool. It covers your profile, every KnownIn tool, resumes, private application answers, company sources, job tracking, and LinkedIn networking.

Job search

Research roles → save as Planned → prepare resume → confirm submission → track

LinkedIn networking

Identify person → save evidence → prepare message + resume → you send → record replies

Paste the KnownIn main prompt

One setup for your profile, job search, applications, resumes, and LinkedIn networking.

Preview main prompt

After setup, ask normally. Research uses the AI tool's available browser/search capabilities; KnownIn keeps your records connected. LinkedIn sending stays manual.