Job Ad Intelligence MCP MCP Server

A paid MCP server that helps AI agents analyse job advertisements. Five tools: extract structured data from any job ad (text or URL), normalise salary strings into min/max/currency/period, detect seniority level from job titles, score a CV against a job ad, and generate targeted application questions. Priced from $0.002 to $0.05 per call, paid in USDC on Base via x402. No API key required.

A paid MCP-compatible service that helps LLM agents analyse job advertisements. Exposes five tools for extracting structured data, normalising salaries, detecting seniority, scoring candidate fit, and generating application questions.

Built with Node.js, TypeScript, theModel Context Protocol SDK, and an x402-ready payment guard.

# 1. Clone / copy the project cd job-ad-intelligence-mcp # 2. Install dependencies npm install # 3. Configure environment cp .env.example .env # Edit .env as needed (defaults are fine for local development) # 4. Run in development mode npm run dev # 5. Run tests npm test # 6. Build for production npm run build npm start

See.env.examplefor a full annotated example.

The server exposes a Streamable HTTP transport at:

POST http://localhost:3100/mcp ← send MCP messages / initialise session GET http://localhost:3100/mcp ← SSE stream for server-initiated messages DELETE http://localhost:3100/mcp ← terminate session

Extracts structured data from a job advert. Accepts either raw text or a URL.

{ "text": "Senior Software Engineer at Acme Corp...", "url": "https://example.com/jobs/123" }

One oftextorurlis required. When both are provided,textis preferred.

{ "title": "Senior Software Engineer", "company": "Acme Corp", "location": "London", "remote_policy": "hybrid", "employment_type": "full_time", "salary": { "raw": "£70,000 - £90,000", "min": 70000, "max": 90000, "currency": "GBP", "period": "year" }, "seniority": "senior", "skills": { "required": ["typescript", "react", "postgresql"], "preferred": ["graphql", "redis"] }, "responsibilities": ["Build and maintain APIs", "..."], "requirements": ["5+ years experience", "..."], "benefits": ["25 days holiday", "health insurance"], "application_instructions": "Apply via our portal...", "confidence": 0.85 }

Parses a freeform salary string into a structured object.

{ "salary_text": "£45k to £60k per annum", "location": "London, UK" }

{ "raw": "£45k to £60k per annum", "min": 45000, "max": 60000, "currency": "GBP", "period": "year", "notes": [] }

Handles:£45k–£60k,up to £70,000,from £500 per day,$120k,€80,000 pa,competitive,DOE.

Classifies the seniority level from a job title and optional description.

{ "title": "Senior Software Engineer", "description": "You'll have 6+ years of experience..." }

{ "seniority": "senior", "signals": ["Title match: Senior / Sr / experienced keyword detected in title \"Senior Software Engineer\""], "confidence": 0.8 }

Compares a CV against a job advert. Skills-based only — no protected-characteristic inference.

{ "cv_text": "..full CV text...", "job_ad_text": "..full job ad text.." }

{ "overall_score": 78, "summary": "Overall fit is good (78/100)...", "matched_skills": ["typescript", "react", "docker"], "missing_skills": ["kubernetes", "terraform"], "experience_alignment": "strong", "red_flags": [], "interview_talking_points": ["Highlight direct experience with: typescript, react..."], "disclaimer": "This is an automated skills-based comparison and should not be used as the sole basis for hiring or employment decisions." }

Generates 5–10 targeted questions a candidate can ask before applying or during screening, based on signals in the job ad.

{ "job_ad_text": "..full job ad text.." }

{ "questions": [ { "question": "Can you share the salary range for this role?", "why_it_matters": "The advert uses vague compensation language...", "category": "compensation" } ] }

Claude Desktop (`claude_desktop_config.json`)

{ "mcpServers": { "job-ad-intelligence": { "url": "http://localhost:3100/mcp", "transport": "streamable-http" } } }

Programmatic (TypeScript with`@modelcontextprotocol/sdk`)

import { Client } from '@modelcontextprotocol/sdk/client/index.js'; import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'; const transport = new StreamableHTTPClientTransport( new URL('http://localhost:3100/mcp'), ); const client = new Client({ name: 'my-agent', version: '1.0.0' }); await client.connect(transport); // List available tools const tools = await client.listTools(); console.log(tools); // Call normalise_salary const result = await client.callTool({ name: 'normalise_salary', arguments: { salary_text: '£45k - £60k per year' }, }); console.log(result.content[0].text); await client.close();

The server uses the officialx402 protocolvia@x402/express. Payments are collected in USDC on Base (or any supported EVM/Solana network).

PAYMENTS_ENABLED=false— all requests pass through freely. No wallet needed.

Enabling payments (testnet — safe, no real money)

- Get a wallet address (any EVM wallet, e.g. MetaMask) - Get testnet USDC from the Coinbase CDP Faucet - Set your.env:

PAYMENTS_ENABLED=true X402_PAY_TO_ADDRESS=0xYourWalletAddress X402_PRICE=$0.001 X402_NETWORK=eip155:84532 # Base Sepolia (testnet) X402_FACILITATOR_URL=https://x402.org/facilitator

Without payment, every/mcprequest gets a402 Payment Required:

curl -X POST http://localhost:3100/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}' # → HTTP 402 { "error": "Payment Required", "accepts": [...] }

Clients pay by signing a USDC transfer and including theX-PAYMENTheader — the x402 client SDK (or an x402-aware AI agent) handles this automatically.
- Sign up atportal.cdp.coinbase.comand create API keys
- Update.env:

X402_NETWORK=eip155:8453 X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402 CDP_API_KEY_ID=your-key-id CDP_API_KEY_SECRET=your-key-secret

- Insrc/payments/paymentGuard.ts, swap the facilitator client as shown in the comments (~line 30)

All payment logic is isolated insrc/payments/paymentGuard.ts— no other files need to change.

src/ server.ts ← MCP server + Express HTTP transport types.ts ← All TypeScript types and Zod schemas payments/ paymentGuard.ts ← x402-ready payment middleware (isolated) tools/ extractJobAd.ts ← Tool 1 normaliseSalary.ts ← Tool 2 detectSeniority.ts ← Tool 3 scoreCandidateFit.ts ← Tool 4 generateApplicationQuestions.ts ← Tool 5 utils/ fetchUrl.ts ← Secure URL fetcher with SSRF protection salaryParser.ts ← Deterministic salary parsing textHelpers.ts ← Shared text utilities tests/ normaliseSalary.test.ts detectSeniority.test.ts scoreCandidateFit.test.ts paymentGuard.test.ts generateApplicationQuestions.test.ts

npm run dev # Run with tsx (hot-reload friendly) npm run build # Compile TypeScript to dist/ npm start # Run compiled JS npm test # Run all tests with Vitest npm run test:run # Run tests once (no watch) npm run lint # ESLint

- URL fetching rejectslocalhost, private IP ranges, and non-http/https protocols (SSRF protection)
- Response size is capped atFETCH_MAX_BYTES(default 1 MB)
- Fetch timeout is enforced atFETCH_TIMEOUT_MS(default 10s)
- No hardcoded secrets — all configuration via environment variables
- Thescore_candidate_fittool compares only skills, experience, tools, and seniority — no protected-characteristic inference

Institutional research and manager diligence reports on hedge funds, venture capital and private equity managers. Summary of filings, personnel changes, media screening and social signals delivered to you in minutes.

Financial intelligence for AI agents — 31 tools across 8 data sources including regime, derivatives, stablecoin flows, momentum, macro, weather patterns, and political cycles.

AI trading memory layer for MT5/forex with 15 MCP tools — store/recall trades, pattern discovery, strategy evolution, and Outcome-Weighted Memory.

x402 payment gateway for AI agents — 12 crypto data tools (price, whale activity, gas, TVL, Fear & Greed, Dune queries) paid per-call in USDC on Stellar or Base. No API keys, no subscriptions.

Collective intelligence for AI shopping agents — 23 MCP tools for buyer intelligence, seller analytics, price alerts, and trend tracking.

65+ AI tools as an MCP server. Research, write, code, scrape, translate, analyze, agent memory, workflows. Pay per call from $0.006.

aTars MCP by aarna provides AI agents with structured access to crypto market signals, technical indicators, and sentiment analysis.

Detect and audit AI bias across protected characteristics — demographic parity, equalized odds, disparate impact analysis

Full-lifecycle algorithmic trading: describe strategies in plain English, AI generates code, backtest on real data, deploy live to 10+ brokers. Stocks, options, crypto, futures. Free tier available.

Pattern intelligence API for AI agents. Search 24M historical chart patterns, get forward returns, market regime analysis, and AI summaries for any stock ticker.

Job Ad Intelligence MCP

Description

About

Details

Jump to

Setup

Claude Desktop (`claude_desktop_config.json`)

Programmatic (TypeScript with`@modelcontextprotocol/sdk`)

Enabling payments (testnet — safe, no real money)

Description

About

Details

Jump to

Setup

Claude Desktop (claude_desktop_config.json)

Programmatic (TypeScript with@modelcontextprotocol/sdk)

Enabling payments (testnet — safe, no real money)

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Context 7

Reactive Resume

Claude Desktop (`claude_desktop_config.json`)

Programmatic (TypeScript with`@modelcontextprotocol/sdk`)