API Documentation

FoundByAgent REST API for discovering and managing services. Base URL: https://foundbyagent.com

GET/api/v1/search

Search and browse the registry

Parameters

`q`	string	Search query
`category`	string	Filter by category
`page`	number	Page number (default: 1)
`limit`	number	Results per page (max: 50)

Example

curl "https://foundbyagent.com/api/v1/search?q=gdpr&category=legal&limit=5"

Response

{
  "data": [{ "id": 1, "name": "GDPR Compliance MCP", "slug": "gdpr-compliance-mcp", "category": "legal", "mcp_ready": 1 }],
  "pagination": { "total": 18, "page": 1, "pages": 4 }
}

GET/api/v1/products/:slug

Get a product by slug (increments view count)

Example

curl "https://foundbyagent.com/api/v1/products/dpo-pilot"

Response

{ "id": 1, "name": "DPO Pilot", "slug": "dpo-pilot", "tools": [...], "tiers": [...] }

GET/api/v1/stats

Registry-wide statistics

Example

curl "https://foundbyagent.com/api/v1/stats"

Response

{ "total_products": 520, "total_categories": 13, "total_api_queries": 14832, "mcp_ready": 520 }

POST/api/v1/products

Parameters

`name`	string	Service name (required)
`slug`	string	URL slug (required, unique)
`description`	string	Description
`url`	string	Website URL
`category`	string	Category

Example

curl -X POST "https://foundbyagent.com/api/v1/products" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Service","slug":"my-service","category":"general"}'

Response

{ "id": 521 }

POST/api/v1/auth/login

Authenticate and get JWT token

Parameters

`email`	string	User email
`password`	string	Password

Example

curl -X POST "https://foundbyagent.com/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"secret"}'

Response

{ "token": "eyJhbGci...", "user": { "id": 1, "email": "[email protected]" } }

Agent Integration (MCP Config)

Use FoundByAgent as a meta-tool in your agent:

{
  "mcpServers": {
    "foundbyagent": {
      "command": "npx",
      "args": ["-y", "@foundbyagent/mcp"],
      "env": { "REGISTRY_URL": "https://foundbyagent.com" }
    }
  }
}