Placed Job Tracker
This skill should be used when the user wants to "track job applications", "add a job application", "update application status", "view my job pipeline", "get application analytics", "delete job application", or wants to manage their job search using the Placed career platform at placed.exidian.tech.
Placed Job Tracker
Track and manage your job applications via the Placed API. No MCP server required — all calls are made directly with curl.
API Key
Load the key from ~/.config/placed/credentials, falling back to the environment:
if [ -z "$PLACED_API_KEY" ] && [ -f "$HOME/.config/placed/credentials" ]; then
source "$HOME/.config/placed/credentials"
fi
If PLACED_API_KEY is still not set, ask the user:
"Please provide your Placed API key (get it at https://placed.exidian.tech/settings/api)"
Then save it for future sessions:
mkdir -p "$HOME/.config/placed"
echo "export PLACED_API_KEY=<key_provided_by_user>" > "$HOME/.config/placed/credentials"
export PLACED_API_KEY=<key_provided_by_user>
How to Call the API
placed_call() {
local tool=$1
local args=${2:-'{}'}
curl -s -X POST https://placed.exidian.tech/api/mcp \
-H "Authorization: Bearer $PLACED_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"$tool\",\"arguments\":$args}}" \
| python3 -c "import sys,json; d=json.load(sys.stdin); print(d['result']['content'][0]['text'])"
}
Available Tools
| Tool | Description |
|---|---|
add_job_application | Add a new job application |
list_job_applications | View all applications, optionally filtered by status |
update_job_status | Move an application to a new stage |
delete_job_application | Remove an application |
get_application_analytics | Pipeline analytics and conversion rates |
Usage Examples
Add a job application:
placed_call "add_job_application" '{
"company": "Stripe",
"position": "Senior Software Engineer",
"job_url": "https://stripe.com/jobs/123",
"status": "APPLIED",
"notes": "Referral from John"
}'
List all applications:
placed_call "list_job_applications"
Filter by status:
placed_call "list_job_applications" '{"status":"INTERVIEWING"}'
Update application status:
placed_call "update_job_status" '{
"job_id": "job_abc123",
"status": "OFFER",
"notes": "Offer: $200K base + equity"
}'
Get analytics:
placed_call "get_application_analytics" '{"date_range":"30d"}'
# Returns: total count, breakdown by status, response rates
Delete an application:
placed_call "delete_job_application" '{"job_id":"job_abc123"}'
Application Statuses
WISHLIST— Saved for laterAPPLIED— Application submittedINTERVIEWING— In interview processOFFER— Offer receivedREJECTED— Application rejectedWITHDRAWN— Withdrew application
Job Search Tips
- Apply to 5-10 roles per week for best results
- Add applications immediately after submitting — tracking works best when complete
- Use
placed-resume-optimizerto tailor your resume before each application - Follow up after 1-2 weeks if no response
- Use analytics to identify which pipeline stages need improvement
- Aim for a 20%+ phone screen rate; if lower, improve your resume
Additional Resources
references/api-guide.md— Full API reference with all parameters and response schemas
Related skills
- Downloads
- 1.2kAll time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.0.1
- License
- MIT-0
