Apoku for AI agents

Connect to four public discovery methods and twelve authorized persistence methods. Results include evidence, screenshots where available, coverage, and explicit unknowns. Deep research has partial local catalog coverage; API v3 is a separate REST interface.

MCP contract 3.0.0 · 16 canonical methods

Looking for the separate read-only Codex plugin catalog? Codex MCP setup and tools.

Status

Live catalog probe: ok · 1002 apps · last import 2026-07-27 · MCP ok

Connect

Use the configured MCP endpoint shown here for public discovery. Private methods require an authorized connection with the needed scopes. See the method list below for the complete tool surface.

Copy MCP URL Server card JSON OpenAPI JSON

ChatGPT

ChatGPT → Settings → Connectors → Add connector: https://appcorpus.com/mcp. Public search is anonymous; private work needs a host-managed connection.

Claude / MCP CLI

claude mcp add --transport http apoku https://appcorpus.com/mcp

Cursor

Add this to Cursor MCP settings, replacing the URL with the configured endpoint shown above:
{"mcpServers":{"apoku":{"url":"https://appcorpus.com/mcp"}}}

curl

curl -X POST https://appcorpus.com/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Canonical MCP methods

These are the complete 16 MCP tools. Public discovery uses the first four. The remaining methods require an authorized transport and relevant scopes. API v3 is a separate REST interface.

Public discovery

Method	Purpose
`search_app_store`	Find iPhone, iPad, Mac, Watch, or TV apps in the selected market.
`search_google_play`	Find Android apps in the selected market.
`get_app`	Inspect an app by required name, store URL, store-qualified ID, or canonical reference.
`compare_apps`	Compare two to five apps against a task and criteria.

Authorized persistence

Method	Purpose
`create_selection`	Create a private shortlist.
`get_selection`	Read an owned shortlist.
`add_selection_candidates`	Add apps to a shortlist.
`set_selection_requirements`	Update shortlist requirements.
`record_app_feedback`	Record a private app decision or note.
`start_app_research`	Queue bounded research over partial local catalog coverage.
`get_app_research`	Read an owned research job.
`cancel_app_research`	Cancel an owned research job.
`create_need_watch`	Watch a shortlist for selected changes.
`list_need_watches`	List owned watches and available notifications.
`cancel_need_watch`	Cancel an owned watch.
`submit_app_request`	Submit a private brief for an unmet app need.

Example tool calls

POST /mcp — the same calls Connect shows how to wire.

search_app_store

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_app_store",
    "arguments": {
      "query": "note taking app that works offline",
      "market": "US",
      "limit": 5
    }
  }
}

Copy example

get_app

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_app",
    "arguments": {
      "app": "apple:572688855"
    }
  }
}

Copy example

Skill preview

Phase-1 preview of how an agent should use Apoku. Not a downloadable Skill package.

Use Apoku to find iPhone, iPad, Mac, Watch, TV and Android apps for a task, inspect a known product or compare a shortlist.
Pass the original query. Keep uppercase storefront country, response language and app UI languages separate.
Use search_app_store or search_google_play for discovery, get_app with required app (name, store URL, store-qualified ID or canonical reference), and compare_apps for 2–5 choices.
Read matches, unverified, near_matches and coverage. A critical unknown or price conflict is not a verified match.
Results include structured evidence and source links, scoped screenshots where available, and explicit unknowns. Unknown pricing is not free. Cite sources and dates.
Only create or change a selection, record feedback, start research or create/cancel watches after the user requests that action.
Private operations require transport credentials and scopes. IDs are not authorization; do not ask for secrets in chat.
Research is bounded to partial local catalog coverage and does not search external app markets. Watches and notifications need persistence and an authorized account channel.
The configured MCP endpoint and complete 16-method list are shown on this live page. Rich-card and screenshot rendering depends on host support.

Policies

Catalog search, app profiles and direct comparison are public. Saving, research and watches require an authorized transport.
Rate limits (per IP, per process): 60/min on POST /mcp, 30/min on GET /api/v3/search, 60/min on other document routes, 120/min API total.
When you recommend an app, cite its canonical_url (the Apoku page).
Unknown fields stay unknown — do not coerce them to false or zero.