> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tendy.by/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Tendy to Claude Desktop for Tender Analysis

> Add Tendy as a remote MCP server in Claude Desktop or Claude.ai to search procurement data and analyze tenders directly in your conversation.

Claude's native MCP support makes it one of the most powerful ways to work with Tendy procurement data. Once you add Tendy as a remote MCP server, you can search tenders, retrieve full documents, and run saved searches without leaving the conversation — and then immediately ask Claude to analyze what it finds, summarize requirements, or compare multiple opportunities side by side.

## Prerequisites

* A Tendy account on the **Basic plan or above**
* **Claude Desktop** (any plan) for the config-file setup, or **Claude.ai** with a plan that supports remote MCP servers

***

## Claude Desktop (Recommended)

Claude Desktop supports remote MCP servers with OAuth authorization out of the box. The first time you use Tendy tools, Claude opens a browser window so you can authorize your account — no token management required.

<Steps>
  <Step title="Open the Claude Desktop configuration file">
    In Claude Desktop, go to **Settings → Developer** and click **Edit Config**. This opens `claude_desktop_config.json` in your default editor.
  </Step>

  <Step title="Add the Tendy MCP server">
    Add a `tendy` entry inside the `mcpServers` object. If the file is empty, replace its contents with the block below; otherwise merge the `tendy` key into your existing `mcpServers` section.

    ```json claude_desktop_config.json theme={null}
    {
      "mcpServers": {
        "tendy": {
          "url": "https://tendy.by/api/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Restart Claude Desktop">
    Save the file, then fully quit and relaunch Claude Desktop so it picks up the new server configuration.
  </Step>

  <Step title="Authorize your Tendy account">
    Start a new conversation and ask Claude to use a Tendy tool — for example, *"Search for active tenders in Minsk."* Claude opens a browser window and redirects you to Tendy's OAuth authorization page. Log in and click **Authorize**. You are returned to Claude Desktop automatically, and the tool call completes.
  </Step>

  <Step title="Confirm the tools are available">
    Click the **Tools** icon (hammer) in the Claude chat toolbar. You should see the Tendy tools listed: `search_tenders`, `get_tender`, `list_saved_searches`, `run_saved_search`, and `list_saved_tenders`. The connection is ready.
  </Step>
</Steps>

***

## Claude.ai (Browser)

If your Claude.ai plan supports remote MCP servers, you can connect Tendy without installing any software.

1. In Claude.ai, go to **Settings → Integrations** (or **Settings → MCP Servers**, depending on your plan).
2. Click **Add remote MCP server** and enter:
   ```
   https://tendy.by/api/mcp
   ```
3. Follow the OAuth prompt to authorize your Tendy account.
4. The Tendy tools become available in all new conversations.

<Note>
  Remote MCP support in Claude.ai is rolling out gradually and may not yet be available on all plans. If you do not see the option, use Claude Desktop instead.
</Note>

***

## Available Tools

After connecting, Claude can call any of these Tendy tools during your conversation:

| Tool                  | What it does                                                                  |
| --------------------- | ----------------------------------------------------------------------------- |
| `search_tenders`      | Search the live tender database by keyword, region, category, value, and more |
| `get_tender`          | Fetch the full details and documents for a specific tender                    |
| `list_saved_searches` | List the saved searches you have configured in Tendy                          |
| `run_saved_search`    | Execute a saved search and return current matching tenders                    |
| `list_saved_tenders`  | Retrieve tenders you have bookmarked in your Tendy account                    |

***

## Example Conversation Starters

Try these prompts to explore what you can do with Tendy in Claude:

* *"Search for construction tenders in Gomel published this week."*
* *"Run my saved search 'IT equipment' and show me the top 5 results."*
* *"Get the full details of this tender: \[paste tender URL or ID]."*

***

## Tips & Notes

<Tip>
  Claude excels at document analysis. Fetch a tender with `get_tender`, then follow up with: *"Summarize the technical requirements"* or *"What are the key eligibility criteria?"* — Claude reads the full tender text and gives you a structured breakdown in seconds.
</Tip>

<Warning>
  Never paste your Personal Access Token into a chat message. If you need to use a PAT instead of OAuth, configure it only inside `claude_desktop_config.json` — not in the conversation itself.
</Warning>