FAQ¶
Frequently asked questions about the Jobko MCP API.
General¶
What is MCP?¶
MCP (Model Context Protocol) is a standard for connecting AI assistants to external tools and data sources. Jobko implements MCP so AI agents like OpenClaw and Claude Desktop can access job matching features.
Do I need to use MCP?¶
No. You can use our REST API with any HTTP client. MCP is optional but provides a better experience with compatible AI assistants.
Which AI assistants work with Jobko?¶
- OpenClaw (native MCP)
- Claude Desktop (native MCP)
- LangChain agents (via REST)
- n8n workflows (via REST)
- Any HTTP client (via REST)
Authentication¶
Where do I get an API key?¶
- Log in to jobko.ai/dashboard
- Go to the Integrations tab
- Click Create API Key
Can I have multiple API keys?¶
Yes. Create separate keys for different applications so you can revoke access individually.
Do API keys expire?¶
No, keys don't expire automatically. You can revoke them manually at any time.
Pricing¶
How much does it cost?¶
| Tool | Cost |
|---|---|
| Profile/credits/jobs lookup | Free |
| Analyze a job | $0.02 |
| Generate a CV | $0.20 |
Do credits expire?¶
No, credits never expire.
Is there a free trial?¶
Yes, new accounts get free credits to test the API.
Do you offer refunds?¶
Contact support@jobko.ai for refund requests.
Tools¶
Why did my job analysis fail?¶
Common reasons:
- URL not accessible: The job posting may have been removed
- Unsupported site: Some sites block scraping
- No profile: User needs to set up their profile first
Try using job_description instead of job_url if the URL doesn't work.
How accurate is the match score?¶
The match score considers:
- Skills match (weighted by level)
- Experience requirements
- Location compatibility
- Salary alignment
- Work mode preferences
It's a helpful signal but not definitive - always read the job posting yourself.
Can I analyze the same job twice?¶
Yes, but it will cost credits each time. Consider caching results on your end.
How long are CV download links valid?¶
CV download URLs expire after 24 hours. Generate a new CV if the link expires.
Technical¶
What's the API request size limit?¶
100KB per request. This is plenty for job descriptions.
Is there a sandbox/test environment?¶
No separate sandbox, but new accounts get free trial credits for testing.
Do you have SDKs?¶
Not yet, but the REST API is simple to use directly. See our integration guides.
Is the API available in my region?¶
The API is globally available with servers in the US and EU.
Security¶
Is my data secure?¶
- All connections use HTTPS/TLS
- API keys are hashed (we can't see them)
- We don't share your data with third parties
- SOC 2 compliance in progress
Can I use the API in production?¶
Yes, the API is production-ready with SLA guarantees for enterprise customers.
Support¶
How do I report a bug?¶
- GitHub: github.com/jobko/api/issues
- Email: support@jobko.ai
How do I request a feature?¶
Open an issue on GitHub or email us. We prioritize based on demand.
Is there a status page?¶
Check status.jobko.ai for service status and incident history.