Ascend MCP Server

Connect Claude (Desktop, Code, or agents) to your Ascend job search data.

What it does

Gives Claude read-only access to:

• Job applications — list, filter by status, get full details with AI analysis
• Resume — your base resume in JSON Resume format
• Dashboard stats — totals, interview counts, match scores
• Analytics — trends and period-over-period comparisons

Setup

1. Get your API key

1. Open Ascend → Settings → Claude AI Integration
2. Click Generate Key and copy the key (shown once)

2. Install dependencies

cd mcp
npm install

3. Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ascend": {
      "command": "node",
      "args": ["/absolute/path/to/ascend/mcp/src/index.js"],
      "env": {
        "ASCEND_API_URL": "https://ascend.workingensemble.ca/api/mcp",
        "ASCEND_API_KEY": "your_key_here"
      }
    }
  }
}

4. Configure Claude Code

claude mcp add ascend \
  -e ASCEND_API_URL=https://ascend.workingensemble.ca/api/mcp \
  -e ASCEND_API_KEY=your_key_here \
  -- node /absolute/path/to/ascend/mcp/src/index.js

Local development

ASCEND_API_URL=http://localhost:4000/api/mcp \
ASCEND_API_KEY=your_key_here \
node mcp/src/index.js

Test with MCP Inspector

cd mcp
ASCEND_API_URL=http://localhost:4000/api/mcp ASCEND_API_KEY=your_key \
  npx @modelcontextprotocol/inspector node src/index.js

Available Tools

| Tool | Description | |------|-------------| | list_applications | List applications with optional status filter | | get_application | Full details for one application including AI analysis | | get_resume | Your base resume in JSON Resume format | | get_dashboard_stats | Total applications, interviews, offers, avg match score | | get_analytics_overview | Trends and analytics for a date range |

Example prompts

• "How many job applications do I have in total?"
• "Show me applications where I'm currently interviewing"
• "What's my average job match score?"
• "Summarize my resume"
• "How has my application rate changed over the last month?"