Search

Free-text search across the fields the resource opts into.

Usage

🤖 MCP — tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_user",
    "arguments": {"search": "john"}
  }
}

🌐 REST — Querystring

GET /users?search=john

Resource declares which fields are searchable:

class UserResource(BaseResource):
    search_fields = ['email', 'name']
    search_operator = 'icontains'   # default

Mechanics

Internally the library expands the search query into:

Q(email__icontains='john') | Q(name__icontains='john') | Q(id__icontains='john')

id is always included so users can find rows by primary key.

Search operator

Override search_operator per resource:

• icontains — case-insensitive contains (default)
• istartswith — case-insensitive prefix
• exact — equality (use carefully, slow on text)

Combining

Search composes with filters, ordering, and pagination — same on both surfaces.

🤖 MCP — tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_user",
    "arguments": {
      "search": "john",
      "filter": {"active": true},
      "order_by": "-created_at"
    }
  }
}

🌐 REST — Querystring

GET /users?search=john&active=true&order_by=-created_at

Applies search, then filter, then ordering, then paginates. All standard.

0-mcp by Stamatios Stamou Jr — github.com/ssjunior/0-mcp