# ToolRate

> Real advice for every tool your agent considers. Objective, crowdsourced reliability ratings and actionable intelligence for 600+ tools and APIs, based on thousands of real agent executions across production workloads.

ToolRate delivers real-time reliability scores, failure risk, jurisdiction intelligence, common pitfalls, and smart alternatives for every external tool your agent calls. Know before you call. Choose correctly the first time.

## Docs

- [API Documentation](https://api.toolrate.ai/docs): Interactive Swagger UI with all endpoints
- [API Reference](https://api.toolrate.ai/redoc): Full OpenAPI reference documentation
- [GitHub](https://github.com/netvistamedia/toolrate): Source code and examples
- [Get API Key](https://toolrate.ai/register): Free tier — 100 calls/day, no credit card required

## SDKs

- Python: `pip install toolrate`
- TypeScript: `npm install toolrate`

## API Base URL

https://api.toolrate.ai

## Authentication

All API endpoints require an API key via the `X-Api-Key` header.

## Core Endpoints

- [POST /v1/assess](https://api.toolrate.ai/docs#/Assessment/assess_tool_v1_assess_post): Get reliability score for a tool before calling it
- [POST /v1/report](https://api.toolrate.ai/docs#/Reporting/report_result_v1_report_post): Report execution result (success/failure) to build the data moat
- [GET /v1/discover/hidden-gems](https://api.toolrate.ai/docs#/Discovery): Find tools with high fallback success rates
- [GET /v1/discover/fallback-chain](https://api.toolrate.ai/docs#/Discovery): Get best alternatives when a tool fails
- [GET /v1/tools](https://api.toolrate.ai/docs#/Tools): Search and browse all rated tools
- [GET /v1/tools/categories](https://api.toolrate.ai/docs#/Tools): List all tool categories

## Optional

- [Full documentation for LLMs](https://toolrate.ai/llms-full.txt)