kyew

Discovery hub. Start here to explore Kyew's capabilities or describe what you want in natural language. This tool is always available.

Actions

help

Get a quick-start guide with the most common workflows.

Parameters

Example request

{
  "name": "kyew",
  "arguments": {
    "action": "help"
  }
}

Example response

{
  "welcome": "Kyew gives you persistent memory, reusable skills, and custom tools across sessions.",
  "quick_start": [
    "1. Start a session: `session(action=\"start\", domain=\"your-project\")`",
    "2. Record observations: `memory(action=\"learn\", observation=\"...\", domain=\"...\", task_type=\"...\", outcome=\"success\")`",
    "3. Find relevant knowledge: `session(action=\"apply\", task=\"what you're working on\")`",
    "4. Report outcomes: `session(action=\"reflect\", skill_id=\"...\", outcome=\"success\")`"
  ],
  "discover": {
    "all_tools": "kyew(action=\"tools\")",
    "search": "kyew(action=\"search\", query=\"...\")",
    "status": "kyew(action=\"status\")",
    "full_guide": "system(action=\"guide\")"
  }
}

tools

List all available tools (built-in, custom, and remote MCP) with their actions.

Parameters

Example request

{
  "name": "kyew",
  "arguments": {
    "action": "tools"
  }
}

Example response

{
  "built_in": [
    { "name": "memory", "description": "Store and recall observations.", "actions": ["learn", "recall", "forget", "correct"] },
    { "name": "session", "description": "Session lifecycle.", "actions": ["start", "apply", "reflect"] },
    { "name": "skill", "description": "Manage reusable skills.", "actions": ["list", "create", "update", "generate", "versions", "rollback", "audit_log", "analyze"] },
    { "name": "task", "description": "Track tasks.", "actions": ["create", "update", "list"] },
    { "name": "tool", "description": "Manage custom tools.", "actions": ["create", "update", "delete", "list", "get", "test"] },
    { "name": "connection", "description": "OAuth connections.", "actions": ["create", "update", "delete", "list", "authorize", "get_token"] },
    { "name": "mcp", "description": "Connect remote MCP servers.", "actions": ["add", "remove", "list", "discover", "refresh"] },
    { "name": "persona", "description": "Manage personas.", "actions": ["list", "load", "create"] },
    { "name": "changes", "description": "Code change proposals.", "actions": ["propose", "list", "apply", "reject"] },
    { "name": "system", "description": "System utilities.", "actions": ["export", "import", "stats", "guide", "setup", "feedback", "share", "list_shares", "accept_share", "decline_share", "revoke_share"] }
  ],
  "custom_tools": [
    { "name": "calculate_statistics", "type": "code" }
  ],
  "remote_mcp": [
    { "name": "github", "server": "GitHub" }
  ]
}

search

Search tools by keyword. Matches against tool names, descriptions, and action names.

Parameters

Example request

{
  "name": "kyew",
  "arguments": {
    "action": "search",
    "query": "share"
  }
}

Example response

{
  "query": "share",
  "results": [
    {
      "name": "system",
      "description": "System utilities.",
      "matched_actions": ["share", "list_shares", "accept_share", "decline_share", "revoke_share"],
      "relevance": "action_match"
    }
  ],
  "total": 1
}

status

Show session information and resource counts for the current user.

Parameters

Example request

{
  "name": "kyew",
  "arguments": {
    "action": "status"
  }
}

Example response

{
  "user_id": "google:112627779572553003904",
  "memories": 47,
  "skills": 5,
  "custom_tools": 2,
  "remote_servers": 1,
  "domains": ["client-reporting", "team-processes", "personal", "persona:jordan"]
}

domains

List all domains with their memory and skill counts.

Parameters

Example request

{
  "name": "kyew",
  "arguments": {
    "action": "domains"
  }
}

Example response

{
  "domains": [
    { "domain": "client-reporting", "memory_count": 12, "skill_count": 2 },
    { "domain": "team-processes", "memory_count": 8, "skill_count": 1 },
    { "domain": "personal", "memory_count": 27, "skill_count": 2 },
    { "domain": "persona:jordan", "memory_count": 14, "skill_count": 0 }
  ],
  "total_domains": 4
}

query

Describe what you want in natural language. Uses AI-powered routing to match your request to the right tool and action. Falls back to keyword search when AI routing is unavailable.

Parameters

Example request

{
  "name": "kyew",
  "arguments": {
    "action": "query",
    "query": "I want to connect my Slack workspace so my AI can post messages"
  }
}

Example response

{
  "interpretation": "Connect a remote service (Slack) via MCP or OAuth connection",
  "suggested_tools": [
    {
      "tool": "mcp",
      "action": "add",
      "reason": "Add a Slack MCP server to proxy its tools through Kyew",
      "example": "mcp(action=\"add\", server_url=\"https://mcp.slack.com/mcp\", name=\"Slack\", tool_prefix=\"slack\")"
    },
    {
      "tool": "connection",
      "action": "create",
      "reason": "Create an OAuth connection for Slack API access",
      "example": "connection(action=\"create\", name=\"Slack\", provider=\"slack\", auth_type=\"oauth2\")"
    }
  ]
}

When to use each action