> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/en/console-mcp.md).

# Using the console with AI

If you connect the Apps in Toss Console MCP, you can perform console tasks in AI tools such as workspaces, miniapps, reviews, bundles, dashboards, in-app payments, in-app ads, promotions, and push notifications without going into the console.

If you make a request in natural language, it will look up console information or carry out the task you need. For example, you can ask like "Tell me the DAU for the last 7 days."

***

### 1. Connect the console MCP

The console is the Apps in Toss website where you register and manage apps. If you connect this MCP, you can carry out console tasks such as workspaces, miniapps, reviews, and bundles just by asking AI, without going directly into the console site.

Try making a request like below.

{% tabs %}
{% tab title="Claude Code" %}

```bash
claude mcp add apps-in-toss-console --transport http https://mcp.toss.im/adapters/apps-in-toss-console/mcp --client-id mcp-gateway
```

{% endtab %}

{% tab title="Codex" %}

```bash
codex mcp add apps-in-toss-console --url https://mcp.toss.im/adapters/apps-in-toss-console/mcp --oauth-client-id mcp-gateway
```

{% endtab %}
{% endtabs %}

After connecting MCP, if a login window appears, complete authentication by following the instructions. Once it is done, check it like below.
\
If AI says it has connected successfully and authentication is complete, then you're done.

```
Check whether the console MCP is connected properly
```

***

### 2. Request console tasks

You can run the console tasks below by asking AI in natural language. For example, you can make requests like this.

* "Tell me the DAU for the last 7 days." → `dashboard_dau`
* "Create a new push template." → `push_template_create`
* "Roll back to the previous bundle version." → `bundle_rollback`

{% hint style="warning" %}
For tasks that are hard to undo or that incur costs, such as bundle rollbacks, promotion budget top-ups, and push sends, be sure to confirm before executing what AI suggests.
{% endhint %}

**Workspaces and miniapps**

<table data-search="false"><thead><tr><th>Tool name</th><th>Description</th></tr></thead><tbody><tr><td><code>workspace_list</code></td><td>View the list of workspaces I belong to.</td></tr><tr><td><code>workspace_get</code></td><td>View detailed information for a specific workspace.</td></tr><tr><td><code>workspace_create</code></td><td>Create a new workspace.</td></tr><tr><td><code>workspace_update</code></td><td>Update workspace information.</td></tr><tr><td><code>workspace_members_list</code></td><td>View the list of workspace members.</td></tr><tr><td><code>miniapp_list</code></td><td>View the list of miniapps in a workspace.</td></tr><tr><td><code>miniapp_get</code></td><td>View detailed information for a specific miniapp.</td></tr><tr><td><code>miniapp_create</code></td><td>Create a new miniapp.</td></tr><tr><td><code>miniapp_get_status</code></td><td>Check the review and operational status of a miniapp.</td></tr><tr><td><code>miniapp_update_basic_info</code></td><td>Update basic information such as the miniapp name and description.</td></tr><tr><td><code>miniapp_update_category</code></td><td>Change the miniapp category.</td></tr><tr><td><code>miniapp_update_icon</code></td><td>Replace the miniapp icon image.</td></tr><tr><td><code>miniapp_update_screenshots</code></td><td>Replace the miniapp screenshots.</td></tr><tr><td><code>miniapp_update_age_rating</code></td><td>Change the miniapp age rating.</td></tr><tr><td><code>miniapp_update_privacy_policy</code></td><td>Update the privacy policy.</td></tr></tbody></table>

**Toss Login settings**

| Tool name                 | Description               |
| ------------------------- | ------------------------- |
| `toss_login_get_config`   | View Toss Login settings. |
| `toss_login_update_terms` | Update Toss Login terms.  |

**Miniapp launch**

<table data-search="false"><thead><tr><th>Tool name</th><th>Description</th></tr></thead><tbody><tr><td><code>bundle_list</code></td><td>View the list of uploaded bundles.</td></tr><tr><td><code>bundle_upload</code></td><td>Upload a new bundle.</td></tr><tr><td><code>bundle_get_live_version</code></td><td>Check the currently live deployed version.</td></tr><tr><td><code>bundle_submit_review</code></td><td>Request a review for the bundle.</td></tr><tr><td><code>review_list</code></td><td>View the list of review requests.</td></tr><tr><td><code>review_get</code></td><td>View detailed information for a review request.</td></tr><tr><td><code>review_get_feedback</code></td><td>Check the review feedback.</td></tr><tr><td><code>review_submit</code></td><td>Request a review.</td></tr><tr><td><code>review_cancel</code></td><td>Cancel the review.</td></tr><tr><td><code>bundle_set_release_note</code></td><td>Write the release notes.</td></tr><tr><td><code>bundle_rollback</code></td><td>Roll back to the previous version.</td></tr></tbody></table>

**Dashboard and analytics**

<table data-search="false"><thead><tr><th>Tool name</th><th>Description</th></tr></thead><tbody><tr><td><code>dashboard_dau</code></td><td>View daily active users (DAU).</td></tr><tr><td><code>dashboard_session</code></td><td>View statistics for session count and session duration.</td></tr><tr><td><code>dashboard_retention</code></td><td>Check retention (return visit rate).</td></tr><tr><td><code>dashboard_conversion</code></td><td>View conversion rate statistics.</td></tr><tr><td><code>dashboard_compare_period</code></td><td>Compare metrics by period.</td></tr><tr><td><code>dashboard_revenue_iap</code></td><td>View the status of in-app payment revenue.</td></tr><tr><td><code>dashboard_revenue_iaa</code></td><td>View the status of in-app ad revenue.</td></tr><tr><td><code>dashboard_export_csv</code></td><td>Export dashboard data as CSV.</td></tr></tbody></table>

**Event logs**

| Tool name              | Description                      |
| ---------------------- | -------------------------------- |
| `event_log_list`       | View the event log list.         |
| `event_log_search`     | Search event logs.               |
| `event_pageview_stats` | View page view statistics.       |
| `event_act_type_get`   | View the event type definitions. |
| `event_act_type_set`   | Set the event type definitions.  |

**In-app payments**

<table data-search="false"><thead><tr><th>Tool name</th><th>Description</th></tr></thead><tbody><tr><td><code>iap_product_list</code></td><td>View the list of in-app products.</td></tr><tr><td><code>iap_product_get</code></td><td>View detailed information for an in-app product.</td></tr><tr><td><code>iap_product_create_inspection</code></td><td>Request a review for a new product.</td></tr><tr><td><code>iap_product_update_inspection</code></td><td>Request a review for the product update.</td></tr><tr><td><code>iap_product_change_status</code></td><td>Start or stop selling a product.</td></tr><tr><td><code>iap_order_list</code></td><td>View payment order history.</td></tr><tr><td><code>iap_refund_list</code></td><td>View the list of refund requests.</td></tr><tr><td><code>iap_revenue</code></td><td>View in-app payment revenue statistics.</td></tr></tbody></table>

**In-app ads**

<table data-search="false"><thead><tr><th>Tool name</th><th>Description</th></tr></thead><tbody><tr><td><code>iaa_placement_group_list</code></td><td>View the ad list.</td></tr><tr><td><code>iaa_placement_group_get</code></td><td>View detailed information for an ad.</td></tr><tr><td><code>iaa_placement_group_create</code></td><td>Create an ad.</td></tr><tr><td><code>iaa_placement_group_update</code></td><td>Edit an ad.</td></tr><tr><td><code>iaa_report_performance</code></td><td>View the performance report.</td></tr><tr><td><code>iaa_report_analytics</code></td><td>View the analytics report.</td></tr><tr><td><code>iaa_dashboard_report_v2</code></td><td>View the dashboard report.</td></tr><tr><td><code>iaa_workspace_dashboard_report_v2</code></td><td>View the dashboard report for all miniapps in the workspace.</td></tr><tr><td><code>iaa_settlement_summary_v2</code></td><td>View the ad settlement summary. <br>(Only admins can view it)</td></tr></tbody></table>

**Promotion**

<table data-search="false"><thead><tr><th>Tool name</th><th>Description</th></tr></thead><tbody><tr><td><code>promotion_list</code></td><td>View the promotion list.</td></tr><tr><td><code>promotion_get</code></td><td>View detailed information for a promotion.</td></tr><tr><td><code>promotion_create</code></td><td>Create a new promotion.</td></tr><tr><td><code>promotion_modify</code></td><td>Edit the promotion.</td></tr><tr><td><code>promotion_review_comment</code></td><td>Check the promotion review comments.</td></tr><tr><td><code>promotion_change_status</code></td><td>Change the promotion status.</td></tr><tr><td><code>promotion_money_balance</code></td><td>Check the promotion budget balance.</td></tr><tr><td><code>promotion_money_charge</code></td><td>Top up the promotion budget.</td></tr><tr><td><code>promotion_money_history</code></td><td>View budget top-up and usage history.</td></tr><tr><td><code>promotion_stats</code></td><td>View promotion performance statistics.</td></tr></tbody></table>

**Push notifications**

<table data-search="false"><thead><tr><th>Tool name</th><th>Description</th></tr></thead><tbody><tr><td><code>push_template_list</code></td><td>View the push template list.</td></tr><tr><td><code>push_template_create</code></td><td>Create a push template.</td></tr><tr><td><code>push_template_update</code></td><td>Edit the push template.</td></tr><tr><td><code>push_target_segment_list</code></td><td>View the list of target segments.</td></tr><tr><td><code>push_target_segment_create</code></td><td>Create a target segment.</td></tr><tr><td><code>push_send_scheduled</code></td><td>Register a scheduled push send.</td></tr><tr><td><code>push_cancel_scheduled</code></td><td>Cancel a scheduled push send.</td></tr><tr><td><code>push_history_list</code></td><td>View push send history.</td></tr><tr><td><code>push_stats</code></td><td>Check push statistics.</td></tr></tbody></table>

**Notice**

| Tool name     | Description                             |
| ------------- | --------------------------------------- |
| `notice_list` | View the notice list.                   |
| `notice_get`  | View detailed information for a notice. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers-apps-in-toss.toss.im/guide/en/console-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.