# lemon.markets MCP

> lemon.markets connects your AI client to European stock and ETF trading data. It lets you automate market analysis, search specific instruments by name or ISIN, get real-time bid/ask quotes, check your current portfolio holdings, and execute buy or sell orders directly through natural language prompts.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** stock-trading, market-data, brokerage-api, etf-trading, real-time-quotes

## Description

Your agent can connect to lemon.markets via this MCP to handle complex European stock trading tasks. You don't need to log into a web portal; you simply instruct your AI client to perform the action. For example, you can ask it to find all available instruments for a specific company or retrieve the latest price quote instantly. The agent then handles everything from checking your account balance using get_brokerage_account to listing every active position with list_active_positions. Need to make a trade? You can tell it to place a new buy or sell order, and even activate pending orders or cancel existing ones. If you're building sophisticated trading logic, Vinkius makes this MCP available in the catalog so your agent always has access to market data. All of this happens without writing any code—just talk to your AI client.

## Tools

### get_brokerage_account
Retrieves your current account information from lemon.markets.

### activate_pending_order
Executes a buy or sell order that has been placed but is not yet active.

### cancel_open_order
Removes an open trading order from your account.

### get_latest_quote
Fetches the current best bid and ask prices for a specified stock or ETF instrument.

### list_brokerage_orders
Displays a list of your most recent trading orders.

### place_new_order
Submits a new buy or sell order, which usually requires subsequent activation.

### list_active_positions
Lists all financial instruments you currently own in your portfolio.

### search_market_instruments
Locates stocks or ETFs by name, company, or specific ISIN code across European exchanges.

## Prompt Examples

**Prompt:** 
```
Find the ISIN for 'Volkswagen' on lemon.markets.
```

**Response:** 
```
I've searched for 'Volkswagen' and found several instruments. The primary ISIN for Volkswagen AG is 'DE0007664039'. Would you like the latest quote for this asset?
```

**Prompt:** 
```
Get the latest ask price for Tesla (ISIN: 'US88160R1014').
```

**Response:** 
```
The latest quote for Tesla (US88160R1014) shows an Ask price of $175.40 and a Bid price of $175.35.
```

**Prompt:** 
```
List my active trading orders.
```

**Response:** 
```
I've retrieved your orders. You have 2 active orders: a BUY for Apple (quantity: 10) and a SELL for BMW (quantity: 5). Both are currently in 'activated' status.
```

## Capabilities

### Search for European Instruments
Find specific stocks or ETFs using their company name or International Securities Identification Number (ISIN).

### Get Real-Time Pricing Data
Retrieve the current best bid and ask prices for any listed financial instrument.

### Manage Trading Orders
Create, activate, cancel, or list all your open buy and sell orders.

### Review Portfolio Status
List every position you currently hold and view detailed account balance information.

## Use Cases

### Checking a Quick Price Change
An investor needs to know if Tesla's price jumped before lunch. Instead of visiting the website, they ask their agent: 'What is the latest quote for US88160R1014?' The agent uses get_latest_quote and gives them the current bid/ask prices instantly.

### Rebalancing a Portfolio
A financial analyst wants to sell some Apple stock and buy more Volkswagen. They ask their agent to check list_active_positions, then place_new_order for the sale, followed by another place_new_order for the purchase.

### Confirming an Order Status
A user placed several orders yesterday and needs to know which ones are still open. They simply prompt: 'List my active trading orders.' The agent runs list_brokerage_orders, showing exactly what's pending or complete.

### Researching a New Investment
A developer needs to know the ISIN for a niche European company. They prompt: 'Search market instruments for XYZ Corp.' The agent uses search_market_instruments and returns the necessary identifier, ready for the next step.

## Benefits

- Get instant pricing data: Use get_latest_quote to pull the bid/ask price for any European stock without opening a separate market feed.
- Manage trades entirely through conversation: Place new orders using place_new_order, then monitor them with list_brokerage_orders. No clicking necessary.
- Stay informed on your holdings: list_active_positions gives you an immediate view of every asset you own and their current status.
- Handle complex workflows: You can search for instruments using search_market_instruments to find the exact ticker needed before running any other tool.
- Complete oversight: get_brokerage_account lets your agent check balance details, making sure your trades are funded correctly.

## How It Works

The bottom line is you use natural language prompts instead of navigating complex trading dashboards or writing API calls.

1. Subscribe to the lemon.markets MCP on Vinkius.
2. Provide your specific lemon.markets API Key to connect your agent.
3. Start by prompting your AI client with a request, like 'What is the latest quote for Siemens?' and let it handle the rest.

## Frequently Asked Questions

**How do I find instruments using lemon.markets MCP?**
You use the search_market_instruments tool. You simply provide the company name or the ISIN, and the MCP returns a list of available stocks or ETFs.

**Can lemon.markets MCP handle trades for European markets?**
Yes, this MCP is specifically designed to manage trading and market data for European stocks and ETFs.

**Do I need to write code to use place_new_order with lemon.markets MCP?**
No, you don't write code. You just tell your AI client through natural language that you want to place a new order, and the agent handles the required parameters.

**What is the difference between list_brokerage_orders and list_active_positions with lemon.markets MCP?**
list_brokerage_orders shows your recent transaction history and pending actions. list_active_positions only lists what you currently own in your portfolio.

**How do I make sure my new order executes after using place_new_order?**
After placing a new order, always prompt the agent to run activate_pending_order. This is necessary for the system to finalize and execute the trade.