- Home
- Skills
- Trading & Investing
- mcp-toss: Toss Securities Assistant
mcp-toss: Toss Securities Assistant
Turn natural-language requests into the right mcp-toss tool calls for Toss Securities market data and account queries.
Free
Works with the AI Agents you already use
mcp-toss: Toss Securities Assistant
Example session with this skill installed
Help me set up mcp-toss in an MCP client that uses a mcpServers JSON configuration. Show the prerequisites and a configuration template using placeholders. Explain how I can verify the connection with a read-only request. Do not install anything, access my accounts, or place an order.
- Read your context and instructions
- Compiled the mcp-toss
Setup guide
mcp-toss runs locally and connects to the Toss Securities Open API using your own credentials. Loading this skill does not install the server or connect your account. This is a setup example, not a live API demonstration.
Prerequisites
- An MCP client that supports local stdio servers.
- Node.js and npm/npx. The package declares Node.js 18 or newer; choose a maintained release that meets that requirement.
- Your own Toss Securities Open API client ID and client secret.
- Network access to openapi.tossinvest.com and the npm registry for initial package installation.
Configuration template
Add this server entry to your client's MCP configuration, preserving any existing entries. Replace the credential placeholders locally; do not share the real values in chat.
{
"mcpServers": {
"toss": {
"command": "npx",
"args": ["-y", "mcp-toss"],
"env": {
"TOSS_CLIENT_ID": "YOUR_CLIENT_ID",
"TOSS_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
}
}
}
}
Leave TOSS_ACCOUNT_NO unset if you do not yet know your account sequence. It is an integer sequence from list_accounts, not a formatted brokerage account number.
Verify without trading
Reload the MCP client and check that tools such as get_prices and get_market_calendar_kr are available. Then ask: "Use mcp-toss to check the Korean market calendar. Do not access my account or submit an order."
Tool discovery verifies that the server is exposed to your client. A successful read-only API response is needed to verify API access. Neither proves that live trading works.
No software was installed, no private account data was accessed, and no order was submitted for this setup guide. It is a configuration example, not a live connection test. The project is unofficial and is not endorsed by Toss Securities.
Connects securely to your tools. The creator never sees your data.
About this skill
Turn natural-language requests into the right mcp-toss tool calls for Toss Securities market data and account queries.
This skill teaches your agent which tools to use, how to interpret their results, and how to distinguish read-only questions from order actions.
What it helps you do
- Query stock prices, order books, recent trades, price limits, and minute or daily candles.
- Look up known stock symbols, stock warnings, KRW/USD exchange rates, and Korean or US market schedules.
- Review your own accounts, holdings, open or closed orders, buying power, sellable quantities, and commissions.
- Prepare order creation, modification, and cancellation previews with explicit account and parameter checks.
- Set up the separate mcp-toss server using your own local credentials.
Order handling
The server pairs each order preview with a single-use confirmation token that expires after 60 seconds. Final order tools require matching parameters. The skill requires explicit user confirmation and respects the host agent's restrictions; hosts that prohibit trading must hand execution to the user.
A preview is generated locally. It is not a brokerage validation, does not submit a trade, and does not guarantee acceptance or execution. A confirmation token does not establish that a human approved an order.
What you need
You must separately configure the mcp-toss server in a client that supports local stdio MCP, install a compatible Node.js runtime, and supply your own Toss Securities Open API credentials. Agensi provides the skill instructions; it does not host the server or supply brokerage access.
Project information
This is an unofficial project, not affiliated with or endorsed by Toss Securities. The underlying mcp-toss server is open source under the MIT license. This skill provides data and workflow assistance, not investment advice or profit guarantees.
Source and documentation: https://github.com/ehdqoddl6/mcp-toss
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Trading & Investing.
Requires separate installation and configuration of the local mcp-toss server and the user's own Toss Securities Open API access. Agensi does not host the server. The current implementation supports 1m/1d candle intervals and KRW/USD currency parameters. Stock lookup requires known symbols rather than free-text company names. Order previews are local and do not validate funds or guarantee brokerage acceptance. Host policies may prohibit live trading. Live API behavior and compatibility across individual agents have not been verified for this submission package.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free to use
No account required to browse
Trust & safety
Security scan
Security scan passed 9 days ago
- Free with an Agensi account
- Accounts
TossinvestToss Securities API key
- Software
- mcp-toss MCP
Node.js 18+npmalso
Set up mcp-toss separately. Your MCP client must support local stdio. Use your own Toss Securities Open API credentials.
Permissions
Allowed Hosts
The skill uses a separately configured local mcp-toss MCP server. The MCP host launches that server via npx; the skill itself does not execute shell commands. The server reads the user's Toss API credentials from its local environment and sends authenticated requests to openapi.tossinvest.com. Initial npx installation uses the npm registry. Account tools access private account data only for the user's request. Order execution tools can submit, modify or cancel real orders and must only be used where permitted by the host and explicitly confirmed by the user. Credentials are not included in this package and must never be uploaded to the listing or pasted into chat.