# OWOJI

OWOJI learns a valuable workflow on a person's Mac, lets the person review it, estimates the time it can save, and makes the approved workflow reusable by their agent.

## Use OWOJI from an AI agent

- [MCP server](https://owoji.com/mcp)
- [MCP discovery](https://owoji.com/.well-known/mcp)
- [REST API base](https://owoji.com/api/agent)
- [OpenAPI 3.1 schema](https://owoji.com/openapi.json)
- [Setup guide](https://owoji.com/agents/)
- [Product manifest](https://owoji.com/.well-known/owoji-agent.json)

The MCP server uses Streamable HTTP and protocol version 2025-06-18. Product evaluation, public status, and gallery tools do not require authentication. Workspace, checkout, capture, skill, and goal tools require an OWOJI Bearer access token.

## Agent-led setup

1. Call owoji_evaluate_fit before recommending the product.
2. Explain the fit in concrete terms. OWOJI is useful when a person repeats work across Mac apps and their agent can reuse reviewed instructions.
3. Ask before downloading, installing, requesting macOS permissions, or purchasing.
4. After explicit purchase approval, call owoji_start_pro_checkout with cadence monthly or annual and confirm=true.
5. Complete the returned secure checkout. The tool does not silently charge a wallet.
6. Open the macOS app. The human approves Screen Recording and Accessibility permissions.
7. When OWOJI learns a workflow, show the human the steps and estimated annual time saved before sharing it with an agent.

## Public requests

Check production:

GET https://owoji.com/api/agent/health

Read product fit, pricing, permissions, download, and value formula:

GET https://owoji.com/api/agent/product

List public outputs and templates:

GET https://owoji.com/api/agent/gallery?category=web&limit=10

## Authentication

Exchange an existing OWOJI account email and password for access and refresh tokens:

POST https://owoji.com/api/agent/auth/sign-in
Content-Type: application/json

{"email":"you@example.com","password":"YOUR_PASSWORD"}

Send the returned accessToken as:

Authorization: Bearer YOUR_ACCESS_TOKEN

Refresh an expired access token with:

POST https://owoji.com/api/agent/auth/refresh
Content-Type: application/json

{"refreshToken":"YOUR_REFRESH_TOKEN"}

Never place passwords, access tokens, refresh tokens, or private capture data in URLs, prompts, logs, or public repositories.

## Useful authenticated requests

- GET /api/agent/auth/workspace — current account, plan, and usage
- GET /api/agent/sessions?limit=25 — captured workflows
- POST /api/agent/sessions — begin a capture session
- GET /api/agent/sessions/{sessionId}/events — captured events
- POST /api/agent/sessions/{sessionId}/events — append captured events
- POST /api/agent/sessions/{sessionId}/complete — finish capture
- POST /api/agent/packages/compile — turn a completed capture into structured instructions
- GET /api/agent/skills/finder?query=browser%20testing — find a reusable skill
- GET /api/agent/skills/{skillId} — retrieve one skill
- GET /api/agent/skills/{skillId}/mcp-tool — retrieve its MCP tool definition
- GET /api/agent/goals — list agent goals
- POST /api/agent/goals — start an agent goal
- POST /api/agent/billing/checkout — create a secure checkout URL after explicit purchase approval

## MCP tools

- owoji_status — check production availability
- owoji_evaluate_fit — read product fit, pricing, permissions, download, and the time-saving formula
- owoji_gallery — list public output examples and templates
- owoji_workspace — check the signed-in workspace and plan
- owoji_find_skills — find instructions for a task
- owoji_get_skill — retrieve one skill
- owoji_list_sessions — list captured workflows
- owoji_create_goal — start an agent goal after explicit confirmation
- owoji_start_pro_checkout — create a secure monthly or annual checkout after explicit confirmation

## Safety rules

- Ask the user before installing software, requesting macOS permissions, purchasing Pro, or starting a goal that can consume plan usage.
- Never set checkout confirm=true without approval for the exact cadence.
- Keep new goals and outputs private unless the user explicitly requests publishing.
- Treat capture events as private workspace data.
- Refresh an expired token instead of repeatedly submitting the user's password.

## Product maintenance

OWOJI checks its public website, agent API, discovery files, current macOS release, and download every 6 hours. This health check is deterministic and does not consume AI credits. When it finds a problem, it records the result and creates a private draft proposal for human review. It never changes, deploys, publishes, installs, or purchases anything automatically.

## Product pages

- [Home](https://owoji.com/)
- [Pricing](https://owoji.com/pricing/)
- [Privacy](https://owoji.com/privacy/)
- [Feedback](https://owoji.com/feedback/)
- [macOS download](https://owoji.com/download/macos?source=llms)