# ferdousbhai/tasty-agent [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/ferdousbhai/tasty-agent  
**GitHub Stars:** 84  
**npm Downloads (last month):** 2209049  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ferdousbhai-tasty-agent

## Description
Tastyworks API integration to handle trading activities on Tastytrade

## Tools
Capabilities this server exposes over MCP:

- **page_offset**
- **limit**
- **target_value**
- **quantity**
- **Buy**
- **Sell**
- **name**
- **group**
- **symbol_count**

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "tasty-agent": {
    "command": "uvx",
    "args": ["modal"],
    "env": {
      "TASTYTRADE_CLIENT_SECRET": "",
      "TASTYTRADE_REFRESH_TOKEN": "",
      "TASTYTRADE_ACCOUNT_ID": ""
    }
  }
}
```

**Requires environment variables:** `TASTYTRADE_CLIENT_SECRET`, `TASTYTRADE_REFRESH_TOKEN`, `TASTYTRADE_ACCOUNT_ID` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What ferdousbhai/tasty-agent MCP server does

The ferdousbhai/tasty-agent MCP server exposes TastyTrade brokerage operations through MCP. It can retrieve account balances and open positions, including net liquidating value, and provide market information for stocks, options, futures, and indices. Market tools cover real-time quotes, option Greeks, IV rank, IV percentile, beta, liquidity, market status, holidays, and symbol search.

Trading functions cover multi-leg order placement, repricing, cancellation, and live-order listing. The server also retrieves transaction and order history with date, symbol, transaction-type, and pagination controls. Watchlist operations can list watchlists, inspect symbols, add or remove symbols, and delete watchlists. An IV Rank Analysis prompt helps analyze IV extremes across positions and watchlists.

## How it works

The server authenticates to TastyTrade with an OAuth client secret and refresh token. An account ID can be supplied when the OAuth grant covers multiple brokerage accounts; it may be omitted for a grant containing only one account.

Quote and Greeks requests use DXLink streaming. When placing an order, the server resolves the requested instruments, fetches current quotes, calculates a signed net midpoint, checks the resulting limit price against bid/ask guardrails, and aligns prices to the broker’s valid tick grid. Option orders require TastyTrade tick-size data; missing data causes the request to fail before submission. A dry-run option is available for order placement.

Quantity can be given directly, or a single-leg equity or equity-option order can be sized from a target value. For multi-leg spreads, quantity represents the leg ratio when target-value sizing is used. Supported order actions include the TastyTrade equity and option actions for opening and closing positions, plus Buy and Sell for futures.

## Setup and configuration

The ferdousbhai/tasty-agent MCP server can run locally over stdio with `uvx tasty-agent`. Configure an MCP client with the `tasty-agent` package and these environment variables:

- `TASTYTRADE_CLIENT_SECRET`
- `TASTYTRADE_REFRESH_TOKEN`
- `TASTYTRADE_ACCOUNT_ID` when needed for multiple accounts

Before configuration, create a TastyTrade OAuth application, enable its scopes, create a personal OAuth grant, and copy the resulting refresh token. The README shows Claude Desktop as a local MCP client. The project also documents deployment on Modal, where clients authenticate with Modal-Key and Modal-Secret headers.

## Tools and capabilities

- Retrieve account balances, positions, and net liquidating value.
- Query quotes, Greeks, market metrics, market status, and symbols.
- Read paginated transaction and order history.
- Place, reprice, cancel, and list orders.
- Manage private watchlists and their symbols.
- Return compact quote, order, buying-power, fee, warning, error, and sizing summaries.

## Limitations and notes

The server can execute live trades, so credentials and order parameters require careful handling. Quote-derived pricing depends on current market data, and option placement stops if required tick-size information is unavailable. The account ID is optional only for single-account OAuth grants. Remote Modal deployment adds proxy authentication requirements beyond the TastyTrade credentials. The project is licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/ferdousbhai-tasty-agent/readme_