mcp-toss: Toss Securities Assistant

    1

    Turn natural-language requests into the right mcp-toss tool calls for Toss Securities market data and account queries.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    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

    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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    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 forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 9 days ago

    • Free with an Agensi account

    Requires

    Tossinvest
    Toss MCP
    Node.js 18+
    npm
    Toss Securities API key
    Node.js
    also

    Permissions

    Network Access
    Terminal / Shell
    Environment Variables

    Allowed Hosts

    openapi.tossinvest.com

    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.

    Listed9 days ago

    What's inside

    Frequently Asked Questions

    No. mcp-toss is an independent, unofficial open-source project and is not affiliated with or endorsed by Toss Securities.

    You need a client that can load SKILL.md instructions and supports local stdio MCP, a separately configured mcp-toss server, Node.js and npm/npx, and your own Toss Securities Open API credentials. The package declares Node.js 18 or newer; use a maintained compatible release. Agensi does not host the local server. Individual agents have not all been tested.

    The underlying server exposes tools that can submit, modify and cancel real orders. They require a matching preview token that expires after 60 seconds. A token is not proof of human consent: the skill additionally requires explicit confirmation of the exact action and compliance with the host's policies. If the host prohibits trading, the user must execute through their brokerage interface. A local preview does not submit an order, validate funds or guarantee acceptance.

    Yes. The mcp-toss server is available under the MIT license at https://github.com/ehdqoddl6/mcp-toss. This listing provides companion instructions for agents using that server.

    No. This package contains skill instructions, a setup reference and the license. Configure the separate mcp-toss server locally and supply your own Toss Securities Open API credentials. Do not share credentials in chat or upload them to Agensi.

    New in Trading & Investing