Skip to main content
Glama
cerase-ai

cerase-search MCP

Official
by cerase-ai

cerase-search MCP

First-party web search for Cerase agents (TOOLS-2). Replaces the external kiso-search. Routed via cerase-litellm.

Tools

Tool

LiteLLM alias

Use

search(agent_id, query)

search (standard)

everyday "find / look up / latest on"

deepsearch(agent_id, query)

deepsearch (advanced)

deeper multi-source research

agent_id is bound by the gateway from the calling Agent's identity (same pattern as cerase-memory's user_id) and is injected into the LiteLLM request as metadata.cerase_agent_id so RecalcTenantUsage attributes the spend per-agent.

Related MCP server: @semidark/mcp-litellm-searxng

Billing

A search costs both:

  • the token charge for the tool model, via the SpendLogs stream, and

  • a flat fee web_search_cr (20 cr) via the gateway's event_log mcp_call row (tool_namebillable_search_tools).

Source of truth: control-plane/config/cerase.php → credit_pricing.

Env

Var

Default

Meaning

LITELLM_BASE_URL

http://cerase-litellm:4000

LiteLLM proxy base

LITELLM_MASTER_KEY

provider key

CERASE_SEARCH_ALIAS

search

override search alias

CERASE_DEEPSEARCH_ALIAS

deepsearch

override deepsearch alias

Run shape

mcp-proxy --port 3000 -- python /app/server.py (MCPServer stdio → HTTP/SSE), identical to the other cerase-* MCP images. GHCR image ghcr.io/cerase-ai/cerase-search-mcp:<tag> built by .github/workflows/docker-publish.yml.

Related MCP Connectors

Related MCP Servers