Content
<div align="center">
<img src="./assets/logo.svg" alt="Daiso MCP" width="120" height="120">
<br>
<br>
# Tool List
Daiso (products/stores/inventory), Lotte Mart (stores/products), GS25 (stores/products/inventory), 7-Eleven (products/stores/inventory/popular search terms/catalog), CU (stores/inventory), Emart24 (stores/products/inventory), Olive Young (stores/inventory), Megabox (theaters/movies/schedules/seats), Lotte Cinema (theaters/movies/seats), CGV (theaters/movies/schedules) query functions are connected to AI.
<br>
[](https://opensource.org/licenses/MIT)
[](https://workers.cloudflare.com/)
[](https://modelcontextprotocol.io/)
[](https://github.com/hmmhmmhm/daiso-mcp/actions/workflows/coverage.yml)
[](https://github.com/hmmhmmhm/daiso-mcp/actions/workflows/coverage.yml)
<!-- WORKERS_INVOCATIONS_CHART:START -->
<h3>Cloudflare Workers Invocations (2026-03-01 ~ 2026-04-29, 60 days)</h3>
<img src="./assets/analytics/workers-invocations.png?v=2026-04-29T16:03:14.653Z" alt="Cloudflare Workers Invocations Graph (2026-03-01 ~ 2026-04-29)" width="100%">
<sub>Worker: <code>daiso-mcp</code> · Last update: 2026-04-30 01:03 KST</sub>
<!-- WORKERS_INVOCATIONS_CHART:END -->
<br>
<br>
<img src="https://i.imgur.com/mPwS4Kv.png" width="400"> <img src="https://i.imgur.com/MrndJ3g.png" width="400">
</div>
<br>
---
<br>
## Connecting MCP to AI Apps
You can connect and use it directly with AI apps like ChatGPT, Claude, and Grok.
Please follow the app-specific guides below to integrate and then request searches/inventory/movie queries.
<br>
### 
> Feedback has been received that MCP integration is difficult, so a GPT app that can be used immediately has been added.
> You can use it easily on mobile by clicking the link below!
**[Daiso MCP GPT App Direct Link](https://chatgpt.com/g/g-69a5266c32108191b71a24642dc63f9e-daiso-mcp)**
Quick usage examples:
```
Tell me about storage box using Daiso MCP
Tell me about Olive Young store near Myeong-dong using Olive Young MCP
Tell me about Emart24 store near Gangnam and inventory of Dubai using Emart24 MCP
Tell me about Lotte Mart store near Jamsil using Lotte Mart MCP
Tell me about inventory of cola at Gangbyeon branch of Lotte Mart using Lotte Mart MCP
Tell me about GS25 store near Gangnam and inventory of sweet potato fries using GS25 MCP
Tell me about 7-Eleven product "samgyetang" using 7-Eleven MCP
Tell me about 7-Eleven store near Ansan Central Station using 7-Eleven MCP
Tell me about inventory of hot dog at 7-Eleven near Ansan Central Station using 7-Eleven MCP
Tell me about popular search terms and catalog summary of 7-Eleven using 7-Eleven MCP
Tell me about movie and remaining seats at Gangnam branch of Megabox using Megabox MCP
Tell me about Lotte Cinema branch near World Tower and movies being shown using Lotte Cinema MCP
Tell me about remaining seats at World Tower branch of Lotte Cinema using Lotte Cinema MCP
Tell me about movies and schedules at Gangnam CGV using CGV MCP
```
<br>
### 
> Pro / Max / Team / Enterprise plan required · Can be used on mobile app when set up on web
1. Go to **Settings** → **Connectors** on [claude.ai](https://claude.ai)
2. Click **Add custom connector**
3. Enter remote MCP server URL: `https://mcp.aka.page`
4. Click **Add** to complete
5. Activate by clicking **+** button → **Connectors** → toggle
Usage examples:
```
Use Daiso MCP to search for storage box
Use Daiso MCP to find stores near Gangnam Station
Use Olive Young MCP to find stores near Myeong-dong
Use Olive Young MCP to check inventory of sunscreen
Use Emart24 MCP to find stores near Gangnam and check inventory of Dubai
Use Lotte Mart MCP to find stores near Jamsil
Use Lotte Mart MCP to check inventory of cola at Gangbyeon branch
Use GS25 MCP to find stores near Gangnam and check inventory of sweet potato fries
Use 7-Eleven MCP to find stores near Ansan Central Station and check inventory of hot dog
Use Megabox MCP to find branches near Gangnam Station
Use Megabox MCP to check movie list and remaining seats at Gangnam branch
Use Lotte Cinema MCP to find branches near Jamsil
Use Lotte Cinema MCP to check movie list and remaining seats at World Tower
Use CGV MCP to find movie theaters in Seoul
Use CGV MCP to check movies and schedules at Gangnam CGV
```
Reference: [Claude Remote MCP Guide](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)
<br>
### 
> Add MCP server to Claude Code CLI
```bash
claude mcp add daiso-mcp https://mcp.aka.page --transport sse
```
<br>
### 
> Supports both web and mobile apps
**Prompt page URL:**
```
https://mcp.aka.page/prompt
```
Usage:
1. Ask the agent to read the page at `https://mcp.aka.page/prompt` on Grok mobile app
2. The agent understands the API usage and executes the function with a GET request
Example conversation:
```
User: Read https://mcp.aka.page/prompt
AI: (Reads the page and understands API usage)
User: Search for storage box
AI: (Calls https://mcp.aka.page/api/daiso/products?q=storage box and provides results)
User: Find Megabox branch near Ansan Central Station
AI: (Calls https://mcp.aka.page/api/megabox/theaters?keyword=Ansan%20Central%20Station and provides results)
User: Find Lotte Cinema branch near Jamsil
AI: (Calls https://mcp.aka.page/api/lottecinema/theaters?keyword=%EC%9E%A0%EC%8B%A4 and provides results)
User: Check CGV schedule at Gangnam
AI: (Calls https://mcp.aka.page/api/cgv/timetable?playDate=20260304&theaterCode=0056 and provides results)
User: Find CGV near Ansan Central Station and check today's movies and schedules
AI: (Calls https://mcp.aka.page/api/cgv/theaters?playDate=20260315&keyword=Ansan%20Central%20Station and provides results)
AI: (Calls https://mcp.aka.page/api/cgv/movies?playDate=20260315&keyword=Ansan%20Central%20Station and provides results)
AI: (Calls https://mcp.aka.page/api/cgv/timetable?playDate=20260315&keyword=Ansan%20Central%20Station and provides results)
```
<br>
### MCP Server URL / CLI (Advanced)
Reference only when directly connecting or using in scripts instead of AI apps.
MCP server URL:
```
https://mcp.aka.page
```
CLI (npx):
```bash
# Interactive mode (recommended)
npx daiso
# Non-interactive mode (CI/scripts)
npx daiso --non-interactive
# Command-line mode
npx daiso help
npx daiso help products
npx daiso url
npx daiso health
npx daiso claude
# Direct queries without AI
npx daiso products storage box
npx daiso product 1034604
npx daiso stores Gangnam Station
npx daiso inventory 1034604 --keyword Gangnam Station
npx daiso display-location 1034604 04515
npx daiso cu-stores Gangnam
npx daiso cu-inventory snacks --storeKeyword Gangnam
npx daiso lottemart-stores Jamsil --area Seoul --limit 10
npx daiso lottemart-products cola --storeName Gangbyeon --area Seoul
npx daiso emart24-stores Gangnam --service24h true
npx daiso emart24-products Dubai --pageSize 20
npx daiso emart24-inventory 8800244010504 --bizNoArr 28339,05015
npx daiso gs25-stores Gangnam --limit 10
npx daiso gs25-products sweet potato fries --limit 20
npx daiso gs25-inventory sweet potato fries --storeKeyword Gangnam --storeLimit 10
npx daiso seveneleven-products samgyetang --size 20
npx daiso seveneleven-stores Ansan Central Station --limit 10
npx daiso get /api/seveneleven/inventory --keyword hot dog --storeKeyword Ansan%20Central%20Station --storeLimit 10
npx daiso seveneleven-popwords --label home
npx daiso seveneleven-catalog --includeIssues true --includeExhibition true --limit 10
npx daiso get /api/cgv/movies --playDate 20260307 --theaterCode 0056
# Original JSON needed
npx daiso products storage box --json
```
### OpenAPI Specification
- OpenAI Chatbot Registration Abbreviated Spec: `https://mcp.aka.page/openapi.json`
- OpenAI Chatbot Registration YAML: `https://mcp.aka.page/openapi.yaml`
- Full Individual Endpoint Spec (JSON): `https://mcp.aka.page/openapi-full.json`
- Full Individual Endpoint Spec (YAML): `https://mcp.aka.page/openapi-full.yaml`
The default `openapi.json` exposes only a single facade, `GET /api/actions/query`, to comply with OpenAI Actions import limitations.
Existing service-specific GET APIs are maintained; detailed background information can be found in the [OpenAPI Actions Facade documentation](./docs/openapi-actions-facade.md).
Interactive Example:
```text
$ npx daiso
Daiso Interactive Mode
[Service Selection]
1. Daiso
2. Olive Young
3. CU
Please select a service number (0: Exit): 1
Enter a store search keyword: Gangnam
[Store Selection]
1. Daiso Gangnam Branch | Seoul Gangnam-gu ...
2. Daiso Gangnam Station Branch | Seoul Gangnam-gu ...
Input: Select a number | /keyword filter | all Show All | 0 Search Again
Selection: /station branch
Selection: 1
[Selected Store Information]
- Store Name: Daiso Gangnam Station Branch
- Address: Seoul Gangnam-gu ...
- Phone: 02-...
Enter a product keyword: Storage Box
[Product Selection]
1. Handle Storage Box (2000 KRW, ID: 1034604)
2. Foldable Storage Box (3000 KRW, ID: 1034605)
Input: Select a number | /keyword filter | all Show All | 0 Cancel
Selection: 1
[Inventory Result]
- Product: Handle Storage Box
- Store: Daiso Gangnam Station Branch
- Inventory Quantity: 7
[Next Action]
1. Find another product at the same store
2. Re-select store/service
3. Exit
Please select a number: 3
Interactive mode exited.
```
<br>
### Unsupported Services
| Service | Status |
| :---------------------------------------------------------------------------------------------------- | :-------- |
|  Google Gemini | ❌ Not Supported |
|  GitHub Copilot | ❌ Not Supported |
<br>
## Special Thanks
We would like to extend our gratitude to those who have contributed to this project.
- [@thecats1105](https://github.com/thecats1105): Implemented Daiso display location query tool (`daiso_get_display_location`) and API/test integration
- [@betterthanhajin](https://github.com/betterthanhajin): Implemented CGV service provider (theater/movie/schedule tool, route specification and test addition)
- [Zerocho](https://youtube.com/shorts/ZgIqA1NCEp0?si=UW0pKsSpqmEi7lXG): Assisted with project promotion
<br>
---
<br>
## Detailed Documentation
Detailed explanations that were previously included have been moved to separate documents.
- [Service Reference](./docs/service-reference.md)
- [CONTRIBUTING Guide](./CONTRIBUTING.md)
<br>
---
<br>
## Documentation
### General Guides
- [Service Reference](./docs/service-reference.md)
- [Scraping Playbook](./docs/scraping-playbook.md)
- [mitmproxy Guide](./docs/mitmproxy-guide.md)
- [AI Instructions](./docs/ai-instruction.md)
### Daiso
- [Daiso Network Analysis Result](./docs/daiso-network-analysis-result.md)
- [Daiso Playwright Network Analysis](./docs/daiso-playwright-network-analysis.md)
- [Daiso Replay Session Test HTML](./docs/daiso-replay-session-test.html)
- [Daiso Test Replay Script](./docs/daiso-test-replay.ts)
### CU
- [CU Network Analysis Result](./docs/cu-network-analysis-result.md)
- [CU App Request Capture Guide](./docs/cu-app-request-capture-guide.md)
- [CU App Scraping Replay Guide](./docs/cu-app-scraping-replay-guide.md)
### Emart24
- [Emart24 Network Analysis Result](./docs/emart24-network-analysis-result.md)
- [Emart24 App Scraping Preparation Guide](./docs/emart24-app-scraping-preparation-guide.md)
- [Emart24 App Scraping Replay Guide](./docs/emart24-app-scraping-replay-guide.md)
### Lotte Mart
- [Lotte Mart Mobile Help Center Scraping Replay Plan](./docs/lottemart-mobile-scraping-replay-plan.md)
### General
- [OpenAPI Actions Facade Refactoring Background](./docs/openapi-actions-facade.md)
### Olive Young
- [Olive Young Network Analysis Result](./docs/oliveyoung-network-analysis-result.md)
- [Olive Young Playwright MCP Onboarding](./docs/oliveyoung-playwright-mcp-onboarding.md)
- [Olive Young Playwright Network Analysis](./docs/oliveyoung-playwright-network-analysis.md)
- [Olive Young Lightpanda Validation](./docs/oliveyoung-lightpanda-validation.md)
- [Olive Young Replay Session Test Script](./docs/oliveyoung-replay-session-test.ts)
- [Olive Young Zyte Bandwidth Test](./docs/oliveyoung-zyte-bandwidth-test.ts)
- [Olive Young Zyte Replay Test](./docs/oliveyoung-zyte-replay-test.ts)
### Movie Theaters
- [CGV Network Analysis Result](./docs/cgv-network-analysis-result.md)
- [Megabox Network Analysis Result](./docs/megabox-network-analysis-result.md)
- [Lotte Cinema Network Analysis Result](./docs/lottecinema-network-analysis-result.md)
### GS25
- [GS25 API Replay Methodology (Final)](./docs/gs25-final-replay-methodology.md)
- [GS25 Network Analysis Result (Archive)](./docs/archive/gs25-network-analysis-result.md)
- [GS25 Android Bypass Capture Guide (Archive)](./docs/archive/gs25-android-bypass-capture-guide.md)
- [GS25 App Capture Attempt Log (2026-03-08, Archive)](./docs/archive/gs25-app-capture-attempt-log-20260308.md)
- [GS25 App Scraping Preparation Guide (Archive)](./docs/archive/gs25-app-scraping-preparation-guide.md)
- [GS25 Session Handover Document (2026-03-09, Archive)](./docs/archive/gs25-session-handoff-20260309.md)
<br>
---
<div align="center">
<br>
MIT License
<br>
</div>
---
## Guidelines for Adding New MCP Features
When adding new services or tools, ensure that implementation is not the only focus; also verify the following:
- `MCP`: Register services in `src/index.ts`, root service/tool list, and related tests
- `HTTPS`: GET API handler/route, prompt page (`src/pages/prompt.ts`), and app integration tests
- `CLI`: `src/cli.ts`, `src/cliHelp.ts`, and CLI tests
- `AI Instruction`: [ai-instruction.md](./docs/ai-instruction.md) usage rules and workflow
- `README`: Supported service descriptions, examples, and documentation links
- `OpenAPI`: Basic `/openapi.json` facade specification, `/openapi-full.json` full specification, and related tests
Minimum verification criteria after feature addition:
- `npm run typecheck`
- `npm test`
Connection Info
You Might Also Like
AP2
AP2 provides code samples and demos for the Agent Payments Protocol.
nuwax
Nuwax AI enables easy building and deployment of private Agentic AI solutions.
daydreams
Daydreams is an AI agent framework in TypeScript for scalable and composable...
concierge
Concierge is a platform for community engagement and scheduling demos.
google-meta-ads-ga4-mcp
MCP server for Google Ads, Meta Ads & GA4 — works with ChatGPT, Claude,...
mcp-server-airbnb
A Desktop Extension for advanced Airbnb search and listings with detailed filtering.