# 100ToolCrate Developer & Agent API Documentation

Welcome to the **100ToolCrate API Documentation**. 100ToolCrate provides 100+ free web and developer utility tools.

---

## Agent Discovery & Protocol Endpoints

1. **API Catalog (RFC 9727)**: `/.well-known/api-catalog`
2. **MCP Server Card (SEP-1649)**: `/.well-known/mcp/server-card.json`
3. **Agent Skills Discovery Index**: `/.well-known/agent-skills/index.json`
4. **OAuth 2.0 Authorization Server**: `/.well-known/oauth-authorization-server`
5. **OAuth Protected Resource Metadata**: `/.well-known/oauth-protected-resource`
6. **Agent Auth Instructions**: `/auth.md`
7. **OpenAPI 3.1 Specification**: `/api/openapi.json`
8. **Health Status**: `/api/status`

---

## Core Endpoints

### GET `/api/status`
Returns server operational health status.

**Response**:
```json
{
  "status": "ok",
  "version": "1.0.0",
  "tools_count": 101,
  "mcp_enabled": true,
  "timestamp": "2026-07-21T13:13:00Z"
}
```

---

### GET `/api/top-tools`
Returns a list of popular tools sorted by usage volume.

**Response**:
```json
{
  "topTools": [
    "word-counter",
    "image-compressor",
    "pdf-merger",
    "json-formatter"
  ]
}
```

---

### POST `/api/track`
Increments tool execution metrics.

**Request Body**:
```json
{
  "id": "word-counter"
}
```

---

### POST `/api/mcp`
Model Context Protocol (MCP) HTTP transport endpoint for invoking agent tools.

---

## Markdown Support for Agents

100ToolCrate supports `Accept: text/markdown` content negotiation. When AI agents send:

```http
GET / HTTP/1.1
Host: 100toolcrate.com
Accept: text/markdown
```

The server responds with clean Markdown content (`Content-Type: text/markdown`) along with the `x-markdown-tokens` header.