Available Tools
The Ryvion MCP endpoint exposes the following tools today. These names match the live server implementation at https://api.ryvion.ai/mcp.
Knowledge base tools
search_knowledge_base
Semantic vector search across one or more knowledge bases.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
kb_id | string | Yes | Knowledge base ID. Supports comma-separated IDs for multi-KB search. |
query | string | Yes | Search query text. |
api_key | string | Yes | Buyer API key for authentication. |
limit | number | No | Maximum results to return. Default 5, max 20. |
list_knowledge_bases
List all knowledge bases available to the authenticated buyer.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | Yes | Buyer API key for authentication. |
chat_with_knowledge_base
Build RAG context from one or more knowledge bases for a user message. This returns the enriched system prompt and source attribution. Use /v1/chat/completions for the actual inference call.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
kb_id | string | Yes | Knowledge base ID. Supports comma-separated IDs for multi-KB context. |
message | string | Yes | User message to ground. |
api_key | string | Yes | Buyer API key for authentication. |
model | string | No | Model hint for context budgeting. Defaults to phi-4. |
get_kb_summary
Return the AAAK wake-up summary for a knowledge base.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
kb_id | string | Yes | Knowledge base ID. |
api_key | string | Yes | Buyer API key for authentication. |
Agent memory tools
store_agent_memory
Store a persistent memory for an agent.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
kb_id | string | Yes | Knowledge base ID. |
agent_name | string | Yes | Agent name. |
key | string | Yes | Memory key. |
value | string | Yes | Memory value. |
memory_type | string | No | fact, preference, context, or learned. Defaults to fact. |
api_key | string | Yes | Buyer API key for authentication. |
recall_agent_memories
Recall all persistent memories for an agent.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
kb_id | string | Yes | Knowledge base ID. |
agent_name | string | Yes | Agent name. |
api_key | string | Yes | Buyer API key for authentication. |
Agent deployment tools
deploy_agent
Create a persistent agent deployment on Ryvion.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Deployment name. |
container_image | string | No | Agent image. Defaults to ghcr.io/ryvion/agent-runner:0.1.0. |
api_key | string | Yes | Buyer API key. |
kb_ids | string | No | Comma-separated knowledge base IDs. |
model | string | No | Preferred model. Defaults to phi-4. |
jurisdiction | string | No | Jurisdiction constraint such as CA, DE, or EU. |
price_cents_per_hour | number | No | Hourly reserve price in cents. |
budget_limit_cents | number | No | Total spend limit in cents. |
max_uptime_hours | number | No | Maximum uptime in hours. |
list_agent_deployments
List all agent deployments for the authenticated buyer.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | Yes | Buyer API key. |
stop_agent
Stop a running deployment.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
deployment_id | string | Yes | Deployment ID to stop. |
api_key | string | Yes | Buyer API key. |
Notes
- The MCP endpoint does not currently expose generic chat completions, embeddings, image generation, audio transcription, or graph query tools.
- Use the REST/OpenAI-compatible API for inference workloads such as
/v1/chat/completions. - MCP is best used here as an integration layer for knowledge, memory, and deployment workflows.