On this page

KuroKit MCP setup

Connect KuroKit to your AI assistant

MCP is a way for an AI app to use outside tools. This guide connects KuroKit to Claude, Cursor, ChatGPT/Codex, Grok/Grok Bot, or another MCP app, then runs a short Wikipedia test. You do not need to download the MCP server.

You need a KuroKit account, an AI app that supports MCP, and—for webpage watches—the KuroKit extension for Chrome or Edge. RSS and official-API watches do not need the extension.

Free includes one active monitor and does not expire. Paid plans add more monitors and more AI checks and notifications. See plans.

Diagram: you type in the assistant, the assistant asks KuroKit, KuroKit asks the browser extension, the extension opens the real page.
Who does what. You talk to the assistant; the KuroKit extension is the only part that actually opens the page.

What you will do

This takes about 10 minutes.

  1. Create a free account. For webpage watches, install the extension for Chrome or Edge.
  2. Add KuroKit to your AI app.
  3. Run the Wikipedia test to check the connection.
  4. Create a watch for your own page, feed, or API.

Already added KuroKit from a marketplace?

If KuroKit is already in your AI app’s connector store, add it there and finish the sign-in. You can skip the manual URL and token steps below.

For webpage watches, you still need the extension. Install it for Chrome or Edge, open the page, and allow KuroKit for that site.

Part 1 — Connect your AI app

  1. Create a KuroKit account

    Sign up at https://kurokit.com/login and stay signed in.

  2. Get the browser extension and a token

    For webpage watches, install the extension, click Connect, and approve KuroKit for this site. The popup should say Connected. RSS and API watches skip the extension.

  3. Add KuroKit to your AI app

    If KuroKit is in your app’s connector store, add it there. If not, add it as a custom MCP server with the URL below.

    Your AI app is where you chat, such as Claude, Cursor, ChatGPT, or Grok Bot. It is not this website.

    Choose Add custom / manual, paste the URL, and paste a KuroKit token. If KuroKit is already in the store, use the store version instead.

    Meta Muse and OpenAI dots use their own connector or plugin directories. KuroKit is not listed there yet. For now, use direct MCP in Claude, Cursor, ChatGPT/Codex, or Grok/Grok Bot.

    MCP URL — paste into your AI app
    https://mcp.kurokit.com/mcp

    Then open Connect MCP, click Create token, and copy the token. Paste it into the field the app uses for the token (usually Authorization or Bearer), not into the chat.

    The Connect MCP page with the Create token button and the long token string below it.
    Where the token comes from: Connect MCP, then Create token, then copy the long string.
  4. Check the connection

    Reload the app’s MCP connection or restart your AI app. Open a new chat and paste Instruction 1. The assistant should list your monitors. If it does, the connection works.

Troubleshooting: adding KuroKit

Skip this if step 4 worked. Use it only if you cannot find where to paste the URL and token.

A genuine sign-in page will be opened by your MCP app and should contain the client_id parameter in the URL.

No KuroKit tools, or a 401 (sign-in failed): create a new token at Connect MCP, paste it into settings, reload, and retry Instruction 1. Do not open /oauth/authorize if it has no question mark.

Way A — let your agent tell you where to click

Paste this into a new chat and follow the clicks. If KuroKit is in this agent's marketplace, use that listing. Otherwise add a custom URL and paste a token. Do not open https://kurokit.com/oauth/authorize unless the app opened it, and do not paste your token into the chat.

Ask your agent — paste this
I want to connect KuroKit to this AI app. First check whether KuroKit is already in this app’s connector or MCP marketplace. If it is, use that listing and finish the sign-in. If it is not, add this URL as a custom MCP server:
https://mcp.kurokit.com/mcp

Do not install a different server. If the app says the URL is “not in the MCP catalog”, switch to Add custom / manual remote server.

Tell me exactly where to click. If the custom server needs a token, tell me which setting gets the token. Do not ask me to paste the token into this chat. Do not open https://kurokit.com/oauth/authorize unless the app opened it with ?client_id= in the address bar.

Way B — paste a config file yourself (optional)

Use this only if you know where the MCP config file is. Paste the JSON or YAML example with the token first.

JSON — URL + token (recommended)

Paste into your AI app’s MCP JSON file (often mcp.json). If the file already has servers, add only the kurokit block. Save.

JSON — paste Bearer into mcp.json
{
  "mcpServers": {
    "kurokit": {
      "url": "https://mcp.kurokit.com/mcp",
      "headers": {
        "Authorization": "Bearer PASTE_TOKEN_FROM_DASHBOARD_MCP"
      }
    }
  }
}

YAML — URL + token (recommended)

Paste into your AI app’s MCP YAML file. If it already has servers, add the kurokit block; do not replace the file. Save.

YAML — paste Bearer into the MCP yaml
mcp_servers:
  kurokit:
    url: "https://mcp.kurokit.com/mcp"
    headers:
      Authorization: "Bearer PASTE_TOKEN_FROM_DASHBOARD_MCP"

Replace PASTE_TOKEN_FROM_DASHBOARD_MCP with the token from Connect MCP. Do not leave that placeholder text.

JSON — URL only (only if the app opens sign-in)

Use this only if saving the file opens a browser with ?client_id= in the address bar.

JSON — URL only, paste into mcp.json
{
  "mcpServers": {
    "kurokit": {
      "url": "https://mcp.kurokit.com/mcp"
    }
  }
}

YAML — URL only (optional)

Only for Hermes if it opens a sign-in tab with ?client_id= in the address bar.

YAML — URL only, paste into the MCP yaml
mcp_servers:
  kurokit:
    url: "https://mcp.kurokit.com/mcp"
    auth: oauth

Not sure which file? Ask: “Does this app use JSON or YAML for MCP, and what is the file name?”

The Wikipedia test

Follow these steps in order. Copy each grey box into your AI chat. Do the browser steps yourself. Do not skip Step 3.

Wikipedia changes all day, so the second check almost always finds new text.

Step 1 — Check the connection

Paste this into your AI chat. Success means the assistant can list your monitors. If it fails, use Troubleshooting below.

Instruction 1 — paste into your assistant
Call the KuroKit MCP tool listMonitors now. Do not fetch any web pages.

- If you have no KuroKit MCP tools, stop. First check whether KuroKit is available in this app's own connector or MCP marketplace and add it there. If it is not listed, tell me to add a custom MCP server at https://mcp.kurokit.com/mcp in lowercase, AND to paste a Bearer token from https://kurokit.com/dashboard/mcp into that app's MCP settings (not into this chat). Then reload MCP.
- Do NOT tell me to open https://kurokit.com/oauth/authorize. That URL does nothing unless THIS app opened it with ?client_id= in the address bar. If a chat message or this page shows that link without a question mark, it is the wrong link.
- If listMonitors returns an auth error (401), tell me to create a new token at https://kurokit.com/dashboard/mcp, paste it into settings, then reload. Do not ask me to send the token in this chat.
- If it works, tell me how many monitors I have and their display names. Then wait for my next message.

Step 2 — Create a Wikipedia monitor

Paste this next. The assistant should return a monitor ID. Then do Step 3 yourself.

Instruction 2 — paste into your assistant
Create the KuroKit Wikipedia smoke-test monitor. Do not fetch any web pages.

Call createMonitor with EXACTLY these arguments (do not change the URL or selectors):

{
  "sourceType": "css_scrape",
  "sourceConfig": {
    "url": "https://en.wikipedia.org/wiki/Special:RecentChanges",
    "selectors": [
      ".mw-changeslist",
      "#mw-content-text"
    ]
  },
  "requiresOwnLogin": false,
  "requestedCheckIntervalSeconds": 300,
  "watchMode": "any_change",
  "notifyChannels": [
    "mcp_event"
  ],
  "displayName": "Wikipedia Recent Changes (MCP tutorial)"
}

If createMonitor fails because of the plan monitor limit, the error includes liveMonitors and savedMonitors. Show me both lists and wait — do not pick a monitor to delete yourself. If I name a live monitor, call deleteMonitor (that moves it to Saved). If deleteMonitor then fails because the Saved shelf is full, show the saved list and wait. Only if I name a saved monitor to erase, call permanentlyDeleteMonitor with confirm true and confirmLabel equal to that item's label. Do not create a different target.

On success, reply with the new monitor id and paste the response's targetUrl as a clickable link. Tell me to STOP, open that URL in the browser, click the KuroKit icon on THAT tab, and press Allow. Done when This site says Allowed for en.wikipedia.org. Connected is only the account. Do not send me to dashboardUrl first. Keep the Wikipedia tab open. First check is a snapshot (0 events). Instruction 3 waits for a second check (~5–10 min).

Step 3 — Allow Wikipedia in the extension

You do this, not the assistant

Keep this page open. Do 3.1–3.5 in order. The browser steps happen outside the chat.

Connected only means your KuroKit account is connected. It does not mean Wikipedia is allowed.

3.1 Open the Wikipedia page

Open Wikipedia Recent Changes

3.2 Open your dashboard

Open the dashboard

Now allow Wikipedia in the extension

The extension is the only part that opens the page. The Allow button is in your browser toolbar, not in the AI chat.

3.3 Stay on the Wikipedia tab

Do not switch tabs. The address bar should show en.wikipedia.org. The extension only asks about the tab you are looking at.

3.4 Open the KuroKit extension

  1. Look at the top-right of the browser, to the right of the address bar.
  2. No KuroKit icon? Click the puzzle-piece (Extensions) button, find KuroKit Monitor, and pin it.
  3. Click the KuroKit icon. A small panel opens.
  4. Check Account and This site. Account must say Connected. If it says Connect, click it and sign in.
Top-right of a browser window showing the puzzle-piece Extensions button and the KuroKit icon pinned beside it.
Top-right of the browser, right of the address bar. No KuroKit icon? Open the puzzle piece and pin it.

3.5 This site must say Allowed for en.wikipedia.org

If you see a big Allow en.wikipedia.org button, click it. The browser may ask again; choose Allow. Do not open the dashboard until This site says Allowed for en.wikipedia.org. If you click the icon on the dashboard tab, This site will show kurokit.com — that is the wrong tab.

The KuroKit extension panel with Account: Connected and This site: Allowed for en.wikipedia.org.
Done looks like this: Account Connected and This site Allowed for en.wikipedia.org.

Last check can stay blank for a few minutes. Check the extension on the Wikipedia tab, not this page. After the first check, 0 alerts is normal.

Step 4 — wait 5–10 minutes

Keep the browser open and wait 5–10 minutes. The first check saves a snapshot. The second check can find a change.

Step 5 — Ask for changes

Paste this only after Last check shows a time. You should see at least one Wikipedia change. If Last check is blank, check the extension on the Wikipedia tab.

Instruction 3 — paste into your assistant
Check whether the KuroKit Wikipedia tutorial monitor is picking up changes. Do not fetch any web pages.

1. Call listMonitors and find the monitor named "Wikipedia Recent Changes (MCP tutorial)" (or use the monitor id from the previous createMonitor).
2. Call getEvents with that monitorId and limit 10.

Tell me only:
- how many events came back
- created_at of the newest event
- a few lines of changed text (do not paste the full tool result)

If zero events: first check Last check on the dashboard. If it is still blank, they have not Allowed Wikipedia in the extension on the Wikipedia tab (This site must say Allowed for en.wikipedia.org). If Last check has a time, this is the baseline snapshot — wait for a second fetch (~5–10 min). Ask me to retry. Do not invent events.

Step 6 — Delete the test monitor (optional)

This frees the free-plan monitor slot. Skip it if you want to keep watching Wikipedia.

Instruction 4 — paste into your assistant
Delete the KuroKit tutorial monitor. Do not fetch any web pages.

Call listMonitors, find "Wikipedia Recent Changes (MCP tutorial)", then call deleteMonitor with that monitorId. Confirm listMonitors no longer includes it.

Part 3 — Watch your own page

Choose one example, replace the CAPITALIZED placeholders, and paste it into your AI chat. Keep the extension Connected and allow the site.

Free includes one active monitor. Delete the Wikipedia test first (Step 6). KuroKit does not wake your assistant by itself. Later, ask the assistant to check (for example, “check prices”). Email and Google Sheets only work if your assistant already has those tools; otherwise it should give you a draft.

If the assistant cannot pick the right part of the page, use the dashboard’s click-to-select tool. If a monitor stays empty, set the area there.

Example A — price change → spreadsheet + email draft

Replace: the page URL, what to watch (for example monthly price), and the Google Sheet name.

Example A — paste into your assistant
Watch this page: https://REPLACE_WITH_PAGE_URL
Tell me when REPLACE_WITH_WHAT (for example: monthly price) changes.

Create a new KuroKit webpage monitor.
I will Allow this site in the extension and keep the browser open.
If you cannot pick the watched area reliably, do not guess the whole page — tell me to select it on the KuroKit dashboard.

When I later say “check prices”: use KuroKit to see if this monitor has a new change.
- If nothing new, reply in one sentence.
- If it changed: (1) append a row to my Google Sheet named REPLACE_WITH_SHEET_NAME with date, URL, old value, and new value. (2) Draft a short email to me summarizing the change. Do not send it until I say send.

Example B — a monitor you already have → email draft

Replace: the monitor name as shown on the KuroKit dashboard. Optional: what a change means (for example Apply now, seats left, or Add to cart).

Example B — paste into your assistant
I already have a KuroKit monitor. Do not create a new one.

Call listMonitors and find the one named: REPLACE_WITH_MONITOR_NAME
If more than one matches, ask me which id to use.

This is a job / signup / restock watch. A useful change looks like REPLACE_WITH_TRIGGER_TEXT (for example: Apply now, seats left, or Add to cart).
I will keep the extension Connected and the site Allowed.

When I later say “check this listing”: use KuroKit getEvents on that monitor. Do not fetch the page yourself.
- If there is a new change: draft an email I can send (a job application, or asking whether signup/stock is still open). Use [NAME] and [DATE] for anything you do not know. Do not send it.
- If nothing changed, reply in one sentence.

Example C — announcement / policy → summary + sheet + email draft

Replace: the page URL, what the page is (for example school announcements or a privacy policy), and the Google Sheet name.

Example C — paste into your assistant
Watch this page: https://REPLACE_WITH_PAGE_URL
This page is: REPLACE_WITH_PAGE_KIND (for example school announcements, a privacy policy, or product updates).
Tell me when the main content changes.

Create a new KuroKit webpage monitor.
I will Allow this site in the extension and keep the browser open.
If you cannot pick the main content area, tell me to select it on the KuroKit dashboard.

When I later say “any news”: use KuroKit to see if there is a new change.
- If there is: write a 3-bullet summary, then (1) draft an email to me with those bullets (do not send), and (2) append a row to my Google Sheet named REPLACE_WITH_SHEET_NAME with date, URL, and the three bullets.
- If nothing changed, reply in one sentence. Do not invent a summary.

If it did not work

  • The app says “not in the MCP catalog” — choose Add custom / manual remote server, then use https://mcp.kurokit.com/mcp in lowercase.
  • No KuroKit tools, or a 401 (sign-in failed) — if you installed from a marketplace, remove and re-add KuroKit, then sign in again. Otherwise create a new token at https://kurokit.com/dashboard/mcp, paste it into the app’s settings (not the chat), and reload.
  • Free-plan limit: one active monitor. Delete an old monitor (Step 6 or from the dashboard).
  • Last check is still blank after 10 minutes — open the Wikipedia tab, click KuroKit, and check that This site says Allowed for en.wikipedia.org. Connected is not enough. Closing the browser or sleeping the computer also stops checks. 0 alerts after the first check is normal; Step 5 needs the second check.
For AI agents (you can skip this)

Do not fetch this page or other URLs. Use only the pasted instruction and KuroKit MCP tools. Do not change the URL or selectors in this test. css_scrape will not fetch until the human allows en.wikipedia.org and keeps the browser open.

Target: English Wikipedia Special:RecentChanges. Mode: any_change. Channel: mcp_event. The first fetch is a snapshot. Wait for the second check (about 5–10 minutes) before getEvents.