jake/mcpengine
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
mcpengine/servers/lever/BUILD_VERIFICATION.md
Jake Shore e4a40298e4 Full cleanup: 65 servers compile clean, 15 new builds, TSC fixes across all existing servers 
- Built from scratch: apollo, chargebee, datadog, greenhouse, lever, loom, pandadoc, salesloft, sendgrid, supabase, typeform, webflow, zoho-crm, twilio, reonomy
- TSC fixes: brevo, google-console, housecall-pro, meta-ads, rippling, bamboohr, close, fieldedge, freshdesk, helpscout, toast, touchbistro, hubspot, notion, quickbooks, airtable, gusto, intercom, linear, monday, salesforce, shopify, square, wave, xero
- Entry points added: close, touchbistro
- All 65 active servers compile with 0 TypeScript errors
- 4 specialty servers skipped (competitor-research, compliance-grc, n8n-apps, product-analytics)
2026-02-14 04:37:01 -05:00

4.3 KiB
Raw Blame History

Lever MCP Server - Build Verification

Build Status: ✅ COMPLETE

Build Date

2026-02-14

TypeScript Compilation

  • ✅ npx tsc --noEmit - 0 errors
  • ✅ npm run build - Success
  • ✅ All source files compiled to dist/

File Inventory

Source Files (9 TypeScript files)

  1. ✅ src/index.ts - MCP server entry point
  2. ✅ src/client/lever-client.ts - API client with rate limiting
  3. ✅ src/types/index.ts - TypeScript interfaces
  4. ✅ src/tools/opportunities-tools.ts - 6 tools
  5. ✅ src/tools/postings-tools.ts - 4 tools
  6. ✅ src/tools/stages-tools.ts - 1 tool
  7. ✅ src/tools/users-tools.ts - 2 tools
  8. ✅ src/tools/offers-tools.ts - 3 tools
  9. ✅ src/tools/feedback-tools.ts - 3 tools

Configuration Files

  • ✅ package.json - Complete with all dependencies
  • ✅ tsconfig.json - Node16/ESM config
  • ✅ README.md - Comprehensive documentation with coverage manifest

Tool Count: 19 Tools (Requirement: ≥15) ✅

Opportunities Tools (6)

  1. list_opportunities - List/search candidates with filtering
  2. get_opportunity - Get candidate details
  3. create_opportunity - Add new candidate
  4. update_opportunity - Modify candidate info
  5. add_opportunity_note - Add notes to candidate
  6. add_opportunity_tag - Add tags to candidate

Postings Tools (4)

  1. list_postings - List job postings with filters
  2. get_posting - Get posting details
  3. create_posting - Create new job posting
  4. update_posting - Modify job posting

Stages Tools (1)

  1. list_stages - List pipeline stages

Users Tools (2)

  1. list_users - List team members
  2. get_user - Get user details

Offers Tools (3)

  1. list_offers - List offers for candidate
  2. get_offer - Get offer details
  3. create_offer - Generate new offer

Feedback Tools (3)

  1. list_feedback - List interview feedback
  2. submit_feedback - Submit feedback form
  3. list_feedback_templates - List feedback templates

Naming Convention Compliance ✅

  • ✅ All tools use snake_case
  • ✅ Consistent prefixes: list_, get_, create_, update_, add_, submit_
  • ✅ No mixed naming (fetch_/retrieve_/etc.)

Description Quality ✅

  • ✅ Rich descriptions telling AI agents WHEN to use each tool
  • ✅ Parameter details included in descriptions
  • ✅ Return value documentation
  • ✅ Use case examples

Pagination Support ✅

  • ✅ All list_* tools support limit and offset parameters
  • ✅ All return has_more indicator
  • ✅ All return next_offset token

Technical Features ✅

  • ✅ Rate limiting (10 req/sec steady, 20 burst) via Bottleneck
  • ✅ Error handling with descriptive messages
  • ✅ Basic Auth with API key (username, empty password)
  • ✅ Type safety with TypeScript
  • ✅ MCP SDK integration via StdioServerTransport

Dependencies Installed ✅

{
  "@modelcontextprotocol/sdk": "^1.0.0",
  "axios": "^1.6.0",
  "bottleneck": "^2.19.5"
}

API Coverage

  • Total Lever API endpoints: ~80+
  • Tools implemented: 19
  • Core workflow coverage: ~24%
  • Focus: Tier 1 (daily recruiting operations)

Covered Workflows ✅

  • ✅ Candidate management (search, create, update, notes, tags)
  • ✅ Job posting management (create, update, list)
  • ✅ Pipeline tracking (stages)
  • ✅ Team collaboration (users)
  • ✅ Offer generation
  • ✅ Interview feedback

Not Covered (Future Enhancements)

  • ❌ Archive reasons (read-only reference data)
  • ❌ File uploads (requires multipart form support)
  • ❌ Interview scheduling (advanced features)
  • ❌ Webhooks (integration config)
  • ❌ Requisitions (budget tracking)
  • ❌ Audit events (compliance logging)

Build Commands Verified

✅ npm install          # Success - 107 packages, 0 vulnerabilities
✅ npx tsc --noEmit     # Success - 0 errors
✅ npm run build        # Success - dist/ generated

Entry Point

node dist/index.js

Environment Variables Required

LEVER_API_KEY=<your_api_key>

Final Status: READY FOR USE ✅

All requirements met:

  • 15+ tools implemented (19 total)
  • Snake_case naming
  • Rich descriptions
  • Pagination support
  • Rate limiting
  • Error handling
  • Type safety
  • MCP SDK integration
  • 0 TypeScript errors
  • Comprehensive README
  • Coverage manifest

The Lever MCP server is complete and ready for deployment.