Developer API Terms
Last updated: April 22, 2026
1. Scope
These Developer API Terms apply in addition to our Terms of Service and govern use of the FindSkills public API (findskills.org/api/v1/*), developer API keys, the CLI (npx findskills), and the MCP server.
2. API Keys
- Keys are personal to you. Do not share, resell, or embed them in public-facing client code.
- You are responsible for all requests made with your key, including requests made by bots or third parties you grant access.
- We may revoke keys at any time for abuse, including without notice for serious violations.
- You must store keys securely (server-side, environment variables, secret managers).
3. Rate Limits
Current rate limits are published at /developers. Attempting to circumvent them (e.g., by creating multiple accounts, rotating IPs, or proxying traffic) is prohibited and grounds for immediate key revocation and account ban.
4. Permitted Use
- Integrating skill discovery into your agent, tool, or IDE extension.
- Building user-facing interfaces that query and display skill metadata with attribution.
- Research and non-commercial projects.
- Commercial use, subject to these Terms and any future supplemental paid-tier terms.
5. Prohibited Use
- Rebuilding a competing directory by bulk scraping or systematic extraction of the dataset.
- Removing or altering attribution, source URLs, or author names in displayed results.
- Reverse engineering rate limits, authentication, or internal endpoints.
- Using the API to distribute malware, phishing content, or illegal material.
- Using the API for any purpose prohibited by our Acceptable Use Policy.
6. Attribution
A "Powered by FindSkills" link pointing to findskills.org is appreciated but not required. Do not imply endorsement or partnership without written permission.
7. Service Levels
- No service-level agreement. We operate on best-effort availability.
- Breaking API changes: we will publish at least 30 days' deprecation notice at /developers and in response
Sunset/Deprecationheaders when feasible.
8. Termination
We may revoke API access at any time with or without cause. On termination, you must cease all use of the API and delete cached data except as required to satisfy outstanding user requests already in flight.
9. Monitoring
We log request metadata (key hash, endpoint, timing, IP, User-Agent, country) for abuse detection, billing, and analytics. See the Privacy Policy.
10. Contact
API support: sean@findskills.org.