MCP Server

The Idynic MCP server lets you manage your career directly from Claude Desktop, Cursor, or any MCP-compatible AI assistant.

MCP (Model Context Protocol) is an open standard for connecting AI applications to external tools and data sources. With the Idynic MCP server, your AI assistant can access your profile, track targets, and generate tailored applications.

Package
@atriumn/idynic-mcp
Requirements
Node.js >= 18
IDYNIC_API_KEY

Installation

Install globally via npm, or run directly with npx without installation.

Global install

Install once and run from anywhere.

npx (no install)

Run directly without installing. Best for quick testing.

Global install
npm install -g @atriumn/idynic-mcp
Run with npx
npx -y @atriumn/idynic-mcp

Configuration

Add the Idynic MCP server to your AI client's configuration.

1. Get your API key

Log into Idynic, go to Settings → API Keys, and create a new key. Copy it immediately—it's only shown once.

2. Add to Claude Desktop

Edit your Claude Desktop config file:

~/.config/claude/claude_desktop_config.json

Environment variables

IDYNIC_API_KEYRequired. Your API key.
IDYNIC_API_URLOptional. Custom API endpoint.
Claude Desktop config
{
  "mcpServers": {
    "idynic": {
      "command": "npx",
      "args": ["-y", "@atriumn/idynic-mcp"],
      "env": {
        "IDYNIC_API_KEY": "idn_your_key"
      }
    }
  }
}

Tools

Tools are functions your AI assistant can call. They perform actions like updating your profile or creating share links.

get_profile

Get your full profile including contact info, work history, skills, and education.

update_profile

Update your contact information.

Params: name, email, phone, location, linkedin, github, website

get_claims

Get your evidence blocks—skills, achievements, education, and certifications with confidence scores.

list_opportunities

List all tracked job targets with match scores.

Params: status (optional)

add_opportunity

Add a new job target by URL or pasting the description.

Params: description (required), url (optional)

analyze_match

Get match analysis for a job—shows strengths, gaps, and recommendations.

Params: id

get_tailored_profile

Get the tailored profile for a specific target.

Params: id

create_share_link

Create a shareable link for a tailored profile.

Params: id

add_and_tailor

Add target + generate tailored profile in one step.

Params: description (required), url (optional)

add_tailor_share

Add target + tailor + create share link (all-in-one).

Params: description (required), url (optional)

Example: Add job and get share link
"I found a Senior Engineer role at Acme.
Here's the description: [paste].
Add it and create a share link."

→ Uses add_tailor_share tool
→ Returns shareable URL
Example: Analyze fit
"How well do I match the Acme role?"

→ Uses analyze_match tool
→ Returns strengths, gaps,
  recommendations
Example: Update profile
"Update my location to NYC"

→ Uses update_profile tool
→ Confirms update

Resources

Resources provide read-only access to your data via URI patterns. Your AI assistant can read these to understand context.

idynic://profileUser profile with contact info and work history
idynic://claimsSkills, education, and certifications with confidence
idynic://opportunitiesList of tracked job targets
idynic://work-historyWork history entries
idynic://opportunity/{id}Specific target details
idynic://opportunity/{id}/matchMatch analysis for a target
Resource URIs
idynic://profile
idynic://claims
idynic://opportunities
idynic://work-history
idynic://opportunity/{id}
idynic://opportunity/{id}/match