Connector guide10-minute read30 MCP tools7 languages

Connect Tenderplan to Meta Muse via MCP

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.

HCBy HelpCode teamUpdated 10 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Tenderplan

Tenderplan

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.

tools

30

Region

INTL

Category

Public Data

Authentication

Bearer Token

Required env vars

TENDERPLAN_API_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

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 Meta Muse in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Tenderplan in the guided setup, then add your MCP URL to Meta Muse. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

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.

Tenderplan · live via MCP
Share
Opus 4.7

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 + Meta Muse

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.

  1. Sign in at https://tenderplan.ru/app and open your profile settings, tab Интеграции с сервисами (Integrations with services).
  2. 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:read and calendar:read. For a read-only setup leave out the two write permissions.
  3. 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: status 1 accepting bids, 2 commission at work, 3 placement finished, 4 cancelled, 5 failed, 6 execution finished, 7 in execution, 8 terminated; kind 0 tender, 1 plan schedule entry, 2 price request; placingWay, type (platform) and region come from the reference lists.
  • Prices: maxPrice is the initial maximum contract price (НМЦ) in the tender's currency.
  • Paging: page starts at 0 and the page size is fixed by Tenderplan; read on until a page comes back empty. Open tasks page with cursor, organizations with from and size.
  • 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_tender 300 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:read and tasks: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 Muse

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 shows YOUR_SERVER_ID.

Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.

  1. In Muse, open Settings → Connectors and choose Add custom connector.
  2. Paste the MCP server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
  3. Muse opens the AnythingMCP sign-in page: sign in and approve access.
  4. In a chat, ask Muse for something that needs the Tenderplan tools.

You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.

Available tools

ToolWhat it does
tenderplan_get_firmRead 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_userRead 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_usersList 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_keysList 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_marksList 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_tendersList 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_tendersList monitored tenders with the newer, richer filter (list version 2): pick a subset (by key, mark, user, bin, legal requests or tasks)…
tenderplan_get_tenderRead 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_infoRead what happened around one tender in a single call: the related records Tenderplan collected for it, such as protocols, contracts and…
tenderplan_list_tender_recordsList one type of record attached to a tender: protocols, contracts, contract stages, explanations (clarifications of the documentation)…
tenderplan_search_tendersSearch the whole Tenderplan tender database (not only your monitored tenders) with key conditions, and read the analytics of the result.…
tenderplan_find_tender_by_numberFind 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_filtersList 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_commentsList all comments your firm wrote on one tender. Returns comments with _id, text (plain text or a rich text object with blocks)…
tenderplan_add_commentWrite 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_tasksList the open tasks across all tenders of your firm. Returns tasks with _id, name, desc (notes), tenderId, assigneeId, dueAt…
tenderplan_list_tender_tasksList the tasks and sections of one tender, open and closed. Returns tasks (_id, name, desc, assigneeId, dueAt, dueCompleteAt…
tenderplan_add_taskAdd 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_taskClose 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_organizationsSearch the organizations Tenderplan knows as customers (buyers) and suppliers (participants), by name or by INN. Use the organization id of…
tenderplan_get_organizationRead the card of one organization (customer or supplier) by its Tenderplan organization id: what Tenderplan holds about that legal entity.…
tenderplan_get_organization_egrulRead data of one organization from the Russian state register of legal entities (ЕГРЮЛ, EGRUL): its branches, representative offices…
tenderplan_get_organization_contactsRead the contacts of one organization as Tenderplan collected them from its tenders. This can include personal data of contact persons: use…
tenderplan_list_rnp_recordsList the entries of one supplier in the register of unreliable suppliers (РНП, version 2). Each entry has _id, id (register number)…
tenderplan_list_notificationsList the current user's notifications as short tender models (version 2): tenders with the tenders the notifications are about. Filter by…
tenderplan_list_calendar_eventsList 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_valuesRead one of Tenderplan's reference lists to translate the numeric ids in tenders and filters: statuses (9 rows: _id, name…
tenderplan_add_tender_marksPut 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_readMark 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_marksTake 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

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.

Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.

Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.

Next steps

Was this guide helpful?

Connect Tenderplan to Meta Muse in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Tenderplan in the guided setup, then add your MCP URL to Meta Muse. No code and no server to run.

Related guides

Connectors

Connect Tenderplan to ChatGPT via MCP

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.

Connectors

Connect Tenderplan to Claude via MCP

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.

Connectors

Connect Tenderplan to Microsoft Copilot via MCP

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.

Connectors

Connect Tenderplan to Cursor via MCP

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.

Connectors

Connect Tenderplan to Gemini CLI via MCP

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.

Connectors

Tenderplan MCP Server: Tenders, Contracts and Tasks

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.