Search API Reference

Resource Search

GET /search

Search across all public resources (MCP servers, MCP tools, agents).

curl -s "https://api.universalapi.co/search?q=web+search&type=mcp&limit=5" | jq

Query Parameters

Parameter	Type	Required	Description
q	string	Yes	Natural language search query
type	string	No	all (default), mcp, mcp-tool, agent
limit	number	No	Max results (default: 10, max: 50)

Response

{
  "data": {
    "results": [
      {
        "resourceId": "mcp-xxx",
        "resourceType": "mcp",
        "name": "serpapi",
        "description": "Search Google, News, and Reddit",
        "slug": "snowtimber/serpapi",
        "score": 0.87,
        "owner": "snowtimber",
        "visibility": "public"
      }
    ],
    "query": "web search",
    "type": "mcp",
    "count": 1
  }
}

Knowledge Search

POST /knowledge/search

Search across your uploaded files. Requires authentication.

curl -s -X POST https://api.universalapi.co/knowledge/search \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "quarterly revenue", "limit": 5}' | jq

Body Parameters

Parameter	Type	Required	Description
query	string	Yes	Natural language search query
folder	string	No	Restrict to a folder
fileType	string	No	Filter by extension (pdf, txt, md)
limit	number	No	Max results (default: 5, max: 20)

Response

{
  "data": {
    "results": [
      {
        "fileName": "Q4-report.pdf",
        "chunk": "Revenue increased 23% year-over-year to $4.2M...",
        "score": 0.92,
        "key": "users/xxx/reports/Q4-report.pdf"
      }
    ],
    "query": "quarterly revenue",
    "count": 1
  }
}