Summary
Tenderplan (tenderplan.ru) API for Russian tender monitoring: tenders found by your saved keys, marks, full tender data with protocols, contracts and complaints, tender search with analytics, comments, tasks, organizations with EGRUL data, the unreliable supplier register, notifications and the tender calendar. Personal access token.
Guided setup
Connect Tenderplan to Claude in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Tenderplan in the guided setup, then add your MCP URL to Claude. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
AnythingMCP is listed in Claude's connector directory: add it to Claude in one click (opens in a new tab), then sign in and choose which MCP servers Claude may use.
Try asking
Example prompts for Tenderplan
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Tenderplan, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Tenderplan + Claude
Tenderplan (tenderplan.ru) API for Russian tender monitoring: tenders found by your saved keys, marks, full tender data with protocols, contracts and complaints, tender search with analytics, comments, tasks, organizations with EGRUL data, the unreliable supplier register, notifications and the tender calendar. Personal access token.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
TENDERPLAN_API_TOKEN
Step 1 — Get credentials
Setting up takes about 3 minutes.
- Sign in at https://tenderplan.ru/app and open your profile settings, tab Интеграции с сервисами (Integrations with services).
- In the block Тендерплан API click Настроить (Set up), type a name under Название токена and tick the permissions under Выберите права, которые будут передаваться по API. For all tools tick
firm:read,user:read,users:read,keys:read,marks:read,relations:read,relations:write,resources:external,resources:personal,comments:read,comments:write,notifications:readandcalendar:read. For a read-only setup leave out the twowritepermissions. - Click Сгенерировать токен (Generate token), copy the token and paste it into
TENDERPLAN_API_TOKEN. Your tokens are listed under Мои токены, where a token can be revoked.
Your Tenderplan role must be allowed to add API access; if the API block is missing, ask the administrator of your firm. The token is sent as Authorization: Bearer. An OAuth 2.0 access token of an application registered with Tenderplan works in the same field (a client credentials token only for the tools that need resources:external); the connector does not renew tokens.
Where to start: tenderplan_get_firm proves the token works and tenderplan_get_current_user tells who it acts for. tenderplan_list_keys (saved searches) and tenderplan_list_marks (labels) give the ids for tenderplan_list_tenders; tenderplan_get_tender reads one tender in full. tenderplan_list_reference_values translates the numeric ids for status, placing way, platform and region.
Tenders: tenderplan_list_tenders lists monitored tenders by one key or mark; tenderplan_filter_tenders is the newer list with status, date window, kind, comment and task filters, and tenderplan_list_saved_filters shows the filters the user saved for it. tenderplan_search_tenders searches the whole database with key conditions and returns tenders or analytics on customers, participants and products. tenderplan_find_tender_by_number turns a notice number into a Tenderplan id. tenderplan_get_tender_related_info returns the related records of a tender in one call, tenderplan_list_tender_records one type at a time (protocols, contracts, stages, explanations, complaints, bank guarantees, РНП entries, attachments).
Teamwork: tenderplan_list_comments and tenderplan_add_comment; tenderplan_list_open_tasks, tenderplan_list_tender_tasks, tenderplan_add_task and tenderplan_complete_task; tenderplan_add_tender_marks and tenderplan_mark_tenders_read; tenderplan_list_users for user ids; tenderplan_list_notifications and tenderplan_list_calendar_events. tenderplan_remove_tender_marks is installed switched off: switch it on only if the assistant may take labels off tenders.
Organizations: tenderplan_search_organizations finds a customer or supplier by name or INN; tenderplan_get_organization, tenderplan_get_organization_egrul and tenderplan_get_organization_contacts read its profile, register data and contact persons; tenderplan_list_rnp_records checks a supplier against the register of unreliable suppliers.
Field notes
- Ids of tenders, keys, marks, users, tasks, comments and organizations are 24-character hex strings. The notice number (
number) is a different thing: resolve it first. - Dates are Unix time in milliseconds (
1647873410678), in filters and in answers. Tender times are moments, not local dates: convert them for the user (Moscow is UTC+3). - Codes are numbers:
status1 accepting bids, 2 commission at work, 3 placement finished, 4 cancelled, 5 failed, 6 execution finished, 7 in execution, 8 terminated;kind0 tender, 1 plan schedule entry, 2 price request;placingWay,type(platform) andregioncome from the reference lists. - Prices:
maxPriceis the initial maximum contract price (НМЦ) in the tender'scurrency. - Paging:
pagestarts at 0 and the page size is fixed by Tenderplan; read on until a page comes back empty. Open tasks page withcursor, organizations withfromandsize. - Search words on tender lists need at least 3 characters.
- Undocumented answers: the public docs describe the answers of the search, comment, task, РНП and saved filter calls; for the other calls read the fields from the answer itself.
- Rate limits: at most 100 calls in 10 seconds and 500 in 60 seconds per user; tender lists 60 per minute,
tenderplan_get_tender300 per minute. Over the limit the API answers 429: wait a minute. - Permissions: every tool description names the permission it needs; a 403 means the token was created without it. The task tools need
tasks:readandtasks:write, which the published permission list does not show: if they answer 403, this token cannot use tasks. - Not included: orders, invoices and tariff purchases, editing keys and marks, user administration and file uploads. No tool moves money.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Claude
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Recommended path: works on claude.ai web without editing any config file.
- In Claude, open Plugins (still called Customize on some plans) → Connectors.
- Click + Add, then Add custom connector.
- Enter a name, e.g.
Tenderplan, and the remote MCP server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, then click Continue, keep the detected settings and click Continue again. - Choose Sign in now, click Add and sign in to AnythingMCP (OAuth) to allow access.
All tools below appear in your chat: start typing prompts.
Available tools
| Tool | What it does |
|---|---|
tenderplan_get_firm | Read the firm (company account) the token belongs to: the firm record of your Tenderplan account. The cheapest call to prove that the token… |
tenderplan_get_current_user | Read the user the token acts for: that user's own record. Use the user's _id as responsible user, task assignee or mention in the other… |
tenderplan_list_users | List the users of your firm in Tenderplan. Use their ids for user_ids filters, as task assignee_id and for comment mentions. No paging… |
tenderplan_list_keys | List the firm's keys: the saved searches Tenderplan runs continuously to collect new tenders. A key has an id, a name and search conditions… |
tenderplan_list_marks | List the firm's marks: the labels users put on tenders to sort them and track the work on them. Pass a mark id as mark_id to… |
tenderplan_list_tenders | List the short models of the tenders your firm monitors, filtered by one key (saved search) or one mark (label). The docs describe the… |
tenderplan_filter_tenders | List monitored tenders with the newer, richer filter (list version 2): pick a subset (by key, mark, user, bin, legal requests or tasks)… |
tenderplan_get_tender | Read the full model of one tender by its Tenderplan id: everything Tenderplan holds about the notice, beyond the short model of the list… |
tenderplan_get_tender_related_info | Read what happened around one tender in a single call: the related records Tenderplan collected for it, such as protocols, contracts and… |
tenderplan_list_tender_records | List one type of record attached to a tender: protocols, contracts, contract stages, explanations (clarifications of the documentation)… |
tenderplan_search_tenders | Search the whole Tenderplan tender database (not only your monitored tenders) with key conditions, and read the analytics of the result.… |
tenderplan_find_tender_by_number | Find tenders by their notice number (the number on zakupki.gov.ru or on the trading platform) anywhere in the Tenderplan database. Use it… |
tenderplan_list_saved_filters | List the list filters the current user saved in Tenderplan (version 2): per subset (type 0 key, 1 mark, 2 user, 3 bin, 4 legal requests… |
tenderplan_list_comments | List all comments your firm wrote on one tender. Returns comments with _id, text (plain text or a rich text object with blocks)… |
tenderplan_add_comment | Write a comment on a tender in the name of the token's user. Colleagues in the firm see it in Tenderplan, which has a notification for new… |
tenderplan_list_open_tasks | List the open tasks across all tenders of your firm. Returns tasks with _id, name, desc (notes), tenderId, assigneeId, dueAt… |
tenderplan_list_tender_tasks | List the tasks and sections of one tender, open and closed. Returns tasks (_id, name, desc, assigneeId, dueAt, dueCompleteAt… |
tenderplan_add_task | Add a task to a tender, optionally with an assignee, a due date and a reminder. Returns the stored task with its _id, createdBy and… |
tenderplan_complete_task | Close a task of a tender, or reopen a closed one. Returns the task with dueCompleteAt set when it is closed. Needs the tasks:write… |
tenderplan_search_organizations | Search the organizations Tenderplan knows as customers (buyers) and suppliers (participants), by name or by INN. Use the organization id of… |
tenderplan_get_organization | Read the card of one organization (customer or supplier) by its Tenderplan organization id: what Tenderplan holds about that legal entity.… |
tenderplan_get_organization_egrul | Read data of one organization from the Russian state register of legal entities (ЕГРЮЛ, EGRUL): its branches, representative offices… |
tenderplan_get_organization_contacts | Read the contacts of one organization as Tenderplan collected them from its tenders. This can include personal data of contact persons: use… |
tenderplan_list_rnp_records | List the entries of one supplier in the register of unreliable suppliers (РНП, version 2). Each entry has _id, id (register number)… |
tenderplan_list_notifications | List the current user's notifications as short tender models (version 2): tenders with the tenders the notifications are about. Filter by… |
tenderplan_list_calendar_events | List the events of the firm's tender calendar in a time window (version 2): the dated events of the tenders your firm monitors. Both ends… |
tenderplan_list_reference_values | Read one of Tenderplan's reference lists to translate the numeric ids in tenders and filters: statuses (9 rows: _id, name… |
tenderplan_add_tender_marks | Put one or more marks (labels) on a tender, keeping the marks it already has. Tenderplan has a notification for marked tenders, so… |
tenderplan_mark_tenders_read | Mark tenders as read for the token's user, the way opening them in Tenderplan does. Up to 100 tenders per call. The answer is not described… |
tenderplan_remove_tender_marks | Take marks (labels) off a tender. Installed switched off: removing a mark drops the tender from that label's list for the whole firm. The… |
Example prompts
- "Which new tenders did my key Медицинское оборудование find this week, with the maximum price?"
- "Show tender 0373100012325000123 with its protocols and contracts."
- "Check the supplier with INN 7701234567 in the unreliable supplier register."
- "Add the comment: prepare the application by Friday, to that tender."
- "Which tasks are open for me, and which tender deadlines are in the calendar next week?"
FAQ
Does it work with Claude Code as well as Claude Desktop? Yes, point both at https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Where does the token come from? In Tenderplan open your profile settings, tab Интеграции с сервисами, block Тендерплан API, click Настроить, name the token, tick the permissions the tools need and click Сгенерировать токен. Your Tenderplan role must be allowed to add API access; if the block is missing, ask the administrator of your firm.
What does it cover? Tenders found by your saved keys and marks, full tender data with protocols, contracts, explanations, complaints and bank guarantees, search across the whole database with analytics, comments, tasks, organizations with EGRUL data and contacts, the register of unreliable suppliers, notifications and the tender calendar. Orders, invoices, tariff purchases, editing keys and marks, user administration and file uploads are not included; no tool moves money.
Which tools install switched off? tenderplan_remove_tender_marks, which takes labels off tenders. Switch it on on the connector page only if the AI should use it. For a read-only setup, create the token without the two write permissions.
Next steps
- Connector landing page
- Connect to ChatGPT
- Connect to Cursor
- Connect to Gemini
- Connect to Meta Muse
- Connect to Microsoft Copilot
Was this guide helpful?