Chip MCP

digital.chip-aiPublished by chip-ai.digitalOfficial publisherv1.3.1Updated Oct 24, 2026

Project memory, tasks and Telegram notifications for your coding agent. Chip account required.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowKnowledge & MemoryCommunication & Collaboration

Overview

AI-generated overview

Chip MCP links a coding agent to a Chip account for persistent project memory, tasks, file uploads and Telegram notifications.

What you can do
  • Read project context: journal, map sections, dialogs, memory search, files and change deltas since the last visit
  • Manage projects: create, rename and archive projects, and list the user's projects
  • Track tasks: list open assignments, add follow-ups for the next session and close finished ones
  • Write memory: save session summaries and notes such as decisions, facts, preferences and pitfalls
  • Reach the user: send Telegram messages and reminders, ask questions with buttons and collect the answer
  • Upload and generate files: put documents into a project, attach files to notifications and generate images
When to use it
Useful when an agent works on the same project across many sessions and should keep decisions, notes and open tasks instead of starting from an empty context. Also fits workflows where a long-running agent needs to report progress or ask the user a question through Telegram.
Requirements
A remote endpoint at chip-ai.digital over streamable HTTP. A free Chip account created through the Telegram bot, plus an issued token (chip_mcp_...) sent as an Authorization Bearer header. The optional Claude Code plugin reads the token from CHIP_MCP_TOKEN and a project_id from a .chip.json file in the repository root.
Before you install
The product is Russian-language: tool responses come back in Russian and billing is in rubles. Writes, Telegram messages and image generation are metered against the user's plan, and generate_image costs about 3 credits per image. Many tools write, send or archive data; a read-only token limits the agent to reading. The token is a credential and should be kept out of repository files.

Installation

In SourceWeft

  1. Open Chip MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/digital.chip-ai%2Fchip/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "chip": {
      "type": "http",
      "url": "https://chip-ai.digital/mcp/"
    }
  }
}

README

Chip MCP

Project memory, tasks and Telegram notifications for your coding agent.

Русская версия · chip-ai.digital/mcp

Chip is an assistant living in Telegram. This MCP server connects your IDE agent — Claude Code, Cursor, anything that speaks MCP — to the same account. Decisions you made yesterday, notes your agent wrote last session, tasks you assigned from your phone: all still there when the next session starts with an empty context window.

Language note. Chip is a Russian-language product: the tools answer in Russian and billing is in rubles. Everything works from any country, but if you don't read Russian, the responses will not be useful to you.

Why bother

Returning to a project costs 63 tokens instead of 2538. Your agent calls whats_new and gets only what changed since its last visit, not the whole project again. Measured 2026-09-10 on a reference mature project with real tiktoken o200k_base counting — not an estimate:

scenariobeforeafter
first visit to a project2538 tokens2284 tokens
returning, nothing changed2538 tokens63 tokens
returning after a day of edits2538 tokens295 tokens

A read-only token costs less to even list. The tool list is paid for by every session before the first call: 27 tools = 2905 tokens, the 11 read-only ones = 1155. If your agent only reads the project, issue a read token and save 1750 tokens per session.

Your agent can reach you. notify_me pushes a message to your Telegram when a long build finishes; ask_user asks a question with buttons and check_confirmation picks up the answer later — so an agent working alone can wait for a human decision instead of guessing.

Install

You need a free account: open @ChipAI_robot in Telegram → mini app → Chip MCP → issue a token (chip_mcp_…). Choose read if you want the agent to look but never touch.

Claude Code

bash
claude mcp add --transport http chip https://chip-ai.digital/mcp --header "Authorization: Bearer chip_mcp_YOUR_TOKEN"

Cursor — ~/.cursor/mcp.json (or .cursor/mcp.json in the project):

json
{  "mcpServers": {    "chip": {      "url": "https://chip-ai.digital/mcp",      "headers": { "Authorization": "Bearer chip_mcp_YOUR_TOKEN" }    }  }}

Any other client that takes an mcpServers entry with url + headers works the same way. See docs/clients.md for more.

Then tell your agent to start with whats_new — the server's own instructions say so too, so most agents do it unprompted.

Claude Code plugin

Claude Code can install everything at once — the server, the session ritual and two commands — instead of you wiring up the config by hand.

bash
export CHIP_MCP_TOKEN=chip_mcp_YOUR_TOKENclaude plugin marketplace add zapret-digital/chip-mcpclaude plugin install chip@chip-ai

The token lives only in CHIP_MCP_TOKEN. It is never written into the plugin files, and never into .chip.json.

What the plugin adds:

  • the chip MCP server, pointed at https://chip-ai.digital/mcp/ — the address is a literal in the plugin, not something the environment can re-point;
  • /chip:start and /chip:finish — the same session ritual as the server's start and finish prompts, for clients that don't render prompts;
  • three hooks: on session start the project delta goes into the context; before context compaction and on stop the agent is reminded to save the summary.

The hooks need a .chip.json in the repository root to know which project this is:

json
{ "project_id": 12 }

The mini app sends it to you — project settings, «Правила для IDE-агента», next to AGENTS.md. Telegram strips the leading dot from attachment names, so rename the file back to .chip.json after saving. Without the file the hooks stay quiet — except for one line at session start saying this repository has no .chip.json. The plugin still works, the session just starts without the delta.

The hooks never block a session — no token, no network, no python3 or curl, and you get one line of explanation instead of a failed start.

For local development: CHIP_MCP_URL re-points the hooks only, and only at the production address or a loopback stand (http://127.0.0.1:PORT/mcp/); anything else is refused. The MCP channel itself ignores the variable, so no repository can send your token to its own host through .claude/settings.json.

Tools

27 tools. read tokens get the 11 marked read; full tokens get everything.

ToolAccessArguments
add_notewriteproject_id, text, kind
add_taskwriteproject_id, text
archive_projectwriteproject_id
ask_userwritequestion, options
attach_filewritefilename, size_bytes
check_confirmationwriteask_id
complete_taskwritetask_id, result
create_projectwritename
finalize_uploadwriteupload_id
generate_imagewriteprompt, project_id
get_project_contextreadproject_id, depth
get_project_mapwriteproject_id
list_filesreadproject_id
list_projectsread—
list_tasksreadproject_id
notify_mewritetext, upload_id
read_journalreadproject_id, offset
read_map_sectionreadproject_id, section
read_project_dialogreadproject_id, session_id
read_project_filereadproject_id, filename, page
rename_projectwriteproject_id, name
save_session_summarywriteproject_id, text
search_projectreadquery, project_id, kind, since
set_reminderwritetext, when
upload_project_filewriteproject_id, filename, size_bytes, content
whats_newreadproject_id, since, session
whoamiread—

get_project_map reads a table of contents but is listed as write, and that is deliberate: fetching it also refreshes the project map, so a read-only token does not get it. read_map_section reads a single entry without side effects.

Machine-readable: spec.json, generated from the server's own tool registry — see below.

What the server can and cannot see

  • It has no access to your filesystem. It only ever receives what your agent explicitly passes as arguments. Nothing scans your repository.
  • Call arguments and results are not logged. The usage log stores the tool name, duration and success flag — nothing else.
  • A read token cannot write. Enforced on the call itself, not just by hiding tools from the list.
  • Tokens are stored as SHA-256. The raw value is shown once, at issue time.
  • Listing tools needs no token, so directories can index this server. Every actual call does.

Verify the spec yourself

spec.json in this repo is generated from the live server's tool registry, so it cannot quietly drift from reality. Check it against production yourself:

bash
./scripts/verify.sh

It diffs the committed spec against https://chip-ai.digital/mcp/spec.json.

Pricing

Connecting is free. Reading your own projects is free. Writes, Telegram messages and image generation are metered against your Chip plan — the tools tell your agent when a limit is reached and what to do about it. Plans live in the Telegram bot.

Links

License

MIT for the contents of this repository (spec, docs, scripts). The Chip service itself is proprietary.

Source: README.md at commit 814e1d0

Tools

27

whoami

Тариф, занятость слотов проектов и (на платном тарифе) остатки дневных лимитов. Зови в начале сессии и когда другой тул отказал по лимиту.

Takes no parameters.

list_projects

Проекты пользователя: id, название, последняя активность, открытые поручения. Нужен project_id — сюда; список меняется редко, не перечитывай.

Takes no parameters.

read_journal

Журнал проекта дословно, новые сверху: сводки сессий и заметки-вехи. Зови за «что было N сессий назад»; поиск по теме — search_project. offset 0 — свежие, дальше листай по подсказке в конце ответа.

Parametersoffsetproject_idrequired

read_project_dialog

Диалог пользователя с Чипом внутри проекта: сводка и последние реплики. Сценарий: надиктовал план с телефона — забери целиком, а не пересказ. Без session_id — самый свежий; id диалогов в get_project_context.

Parametersproject_idrequiredsession_id

get_project_map

Оглавление карты проекта: полочки-статьи с актуальным знанием, которые Чип ведёт по журналу (не лента). Сама статья — read_map_section.

Parametersproject_idrequired

read_map_section

Статья одной полочки карты — актуальное знание по теме («Решения», «Грабли»…). Зови по оглавлению из get_project_context или get_project_map.

Parameterssectionrequiredproject_idrequired

get_project_context

Контекст проекта: инструкции, поручения, оглавление карты, память, файлы, диалоги. Зови ОДИН раз, когда берёшься за проект впервые; вернулся в знакомый — whats_new, он дешевле. depth: "brief" (сводки аннотациями, по умолчанию) или "full" (дословно).

Parametersdepthproject_idrequired

search_project

Поиск по знанию проекта: полочки карты, журнал, память, диалоги. Зови за конкретным фактом или старым решением, которого нет в контексте. Без project_id — по всем проектам сразу. Запрос — 1–3 ключевых слова, не предложение. kind сужает память до вида (decision, pitfall, fact, preference, progress, correction); since (ISO, как курсор) режет старое.

Parameterskindqueryrequiredsinceproject_id

list_files

Файлы базы знаний проекта: имя, размер, читаемость. Зови перед read_project_file, если точное имя неизвестно.

Parametersproject_idrequired

read_project_file

Текст файла из базы знаний проекта, страницами. Без page у длинного документа придёт оглавление — выбери раздел и позови с page=N; дальше листай по подсказке в конце ответа.

Parameterspagefilenamerequiredproject_idrequired

create_project

Завести проект в Чипе. Зови по просьбе пользователя — или предложи сам, если работаете над задачей без проекта. Название — по сути задачи, до 60 символов.

Parametersnamerequired

rename_project

Переименовать проект (до 60 символов). Только по явной просьбе пользователя.

Parametersnamerequiredproject_idrequired

archive_project

Архивировать проект: уходит из списка, слот освобождается, данные целы. Зови, когда пользователю нужен слот под новый. Вернуть из архива и удалить проект может только он сам, в мини-аппе.

Parametersproject_idrequired

save_session_summary

Сводка рабочей сессии — в журнал проекта. Зови В КОНЦЕ сессии или перед долгой паузой, один раз — не дроби. Структура: Сделано → Решения и почему (включая отвергнутые) → Грабли → Осталось. До 6000 символов, на языке пользователя.

Parameterstextrequiredproject_idrequired

add_note

Заметка в память проекта (до ~300 символов; грабли и правки — 600). Пиши по ходу: одно наблюдение — одна заметка. kind: decision — сделанный выбор (полочка «Решения»), fact — как устроено, preference — как любит пользователь, progress — что сделано, pitfall — грабли «симптом → причина → лечение» (полочка «Грабли»), correction — «раньше X, теперь Y». Решение пиши формулой «что решали → выбрали X вместо Y, потому что Z»: ✓ «Очередь задач: Redis вместо Kafka — один инстанс, 200 rps». ✗ «Используем Redis» — следующая сессия переспорит то же самое.

Parameterskindtextrequiredproject_idrequired

whats_new

Изменения в проекте с твоего прошлого захода: журнал, поручения, файлы, полочки карты, диалоги. Зови ПЕРВЫМ, как взялся за проект: в знакомом — только дельта, впервые — сразу полный контекст. Скажет «изменений много» — добери get_project_context. since — из «Курсора» прошлого ответа, session — метка твоей ветки: покажу соседние сессии этого токена.

Parameterssincesessionproject_idrequired

list_tasks

Поручения тебе в этом проекте: их ставит пользователь и прошлая сессия (add_task, хвосты «Осталось»). Зови в начале работы и когда ищешь, чем заняться дальше. Сделанное закрывай complete_task — незакрытое всплывёт снова.

Parametersproject_idrequired

complete_task

Закрыть поручение из list_tasks: result — что сделано (1–2 фразы, до 500 символов, пользователь прочитает это в Telegram). Зови СРАЗУ по факту, не пачкой в конце. Не закрывай то, за что не брался.

Parametersresultrequiredtask_idrequired

add_task

Поручение следующей сессии агента: хвост из «Осталось», который не успел сделать. Пользователь видит его в мини-аппе, следующая сессия — в list_tasks.

Parameterstextrequiredproject_idrequired

notify_me

Сообщение пользователю в Telegram: итог долгой задачи («тесты зелёные», «сборка упала»), важное событие. НЕ для болтовни и не для вопросов — вопрос задавай в сессии. До 1000 символов. Показать скриншот, PDF или лог — сначала attach_file, потом сюда upload_id.

Parameterstextrequiredupload_id

set_reminder

Напоминание пользователю в Telegram — для отложенных проверок и дедлайнов. when — ISO-время («2026-07-25T10:00»), без пояса = локальное время пользователя. Текст до 200 символов.

Parameterstextrequiredwhenrequired

ask_user

Спросить пользователя кнопками в Telegram, когда упёрся в развилку, которую решает он сам («какую БД берём?»). НЕ для мелочей, решаемых здравым смыслом. options — 2–4 коротких варианта (по умолчанию Да/Нет). Молчит — вернётся id для check_confirmation.

Parametersoptionsquestionrequired

check_confirmation

Забрать ответ пользователя на вопрос ask_user (если тот вернул id). Зови не чаще раза в минуту-другую.

Parametersask_idrequired

upload_project_file

Выгрузить файл в проект (md, txt, csv, json, pdf, docx, xlsx и др.) — пользователь откроет его с телефона. Зови, когда результат нужен ему в Чипе; код оставляй в репозитории. До ~20k символов — сразу в content, крупнее — укажи size_bytes и загрузи по инструкции из ответа. Картинки — generate_image. ПЛАТНО для многостраничного PDF: оглавление к нему списывает кредиты пользователя.

Parameterscontentfilenamerequiredproject_idrequiredsize_bytes

finalize_upload

Завершить двухфазную загрузку файла: зови ПОСЛЕ того, как curl из ответа upload_project_file отработал успешно.

Parametersupload_idrequired

attach_file

Вложение для notify_me: скриншот после правки интерфейса, PDF, лог. В проект не сохраняется, живёт до отправки.

Parametersfilenamerequiredsize_bytesrequired

generate_image

Сгенерировать картинку 1024×1024. ПЛАТНО: списывает с баланса пользователя ~3 кредита — зови по его запросу, не «на пробу». С project_id PNG ляжет в файлы проекта, без него — временная ссылка, скачай сразу.

Parameterspromptrequiredproject_id

Version history

1
  1. v1.3.1LatestSep 20, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts