KLinePic MCP Server

Content

KLinePic is an MIT-licensed stdio MCP adapter for creating annotated post-trade candlestick review-chart PNGs from broker or exchange fills. It connects Claude and other MCP clients to the hosted KLinePic Agent API while keeping capability discovery and request validation separate from the quota-consuming render operation.

The server exposes exactly three tools:

• klinepic_get_capabilities checks key permissions, supported endpoints, plan limits, and remaining quota.
• klinepic_preflight_review_chart validates fills, K-line data, scopes, and estimated cost without consuming chart-render quota.
• klinepic_create_review_chart returns an annotated candlestick PNG as native MCP image content and consumes one chart render.

Verified Behavior

The public adapter repository documents and exercises the following checks:

• Four API adapter tests pass.
• A real MCP stdio initialization and tools/list handshake discovers all three tool schemas.
• A fresh Windows Cline-compatible cmd /c npx installation from an empty directory completes MCP initialization and tool discovery.
• Live production capability discovery and no-charge preflight pass with a scoped Agent API key.
• GitHub Actions builds the Docker image from a clean Linux checkout.
• The official MCP Registry lists io.github.sher1096/klinepic as an active server package.

These checks establish installation, schema discovery, and preflight behavior. They do not turn KLinePic into a trading signal or order-execution system.

Installation

Run the server directly from its public GitHub repository:

npx -y github:sher1096/klinepic-agent-api-examples#c48f3dc12a21834a2af165c223230f0cf9500fef

For Claude Code on macOS or Linux:

claude mcp add klinepic \
  --env KLINE_AGENT_API_KEY=YOUR_KLINEPIC_AGENT_API_KEY \
  -- npx -y github:sher1096/klinepic-agent-api-examples#c48f3dc12a21834a2af165c223230f0cf9500fef

For JSON-based MCP clients:

{
  "mcpServers": {
    "klinepic": {
      "command": "npx",
      "args": [
        "-y",
        "github:sher1096/klinepic-agent-api-examples#c48f3dc12a21834a2af165c223230f0cf9500fef"
      ],
      "env": {
        "KLINE_AGENT_API_KEY": "YOUR_KLINEPIC_AGENT_API_KEY"
      }
    }
  }
}

On Windows clients that do not resolve npx directly, use cmd as the command and ["/c", "npx", "-y", "github:sher1096/klinepic-agent-api-examples#c48f3dc12a21834a2af165c223230f0cf9500fef"] as the argument list. Keep the API key in the same environment block.

Recommended Workflow

1. Call klinepic_get_capabilities and inspect scopes, limits, and quota.
2. Prepare broker or exchange fills plus matching K-line data.
3. Call klinepic_preflight_review_chart to catch malformed data, unsupported sources, missing scopes, IP restrictions, plan state, and quota issues.
4. Review the validation result and estimated chart cost.
5. Ask the user to confirm the render.
6. Call klinepic_create_review_chart and inspect the returned PNG.

Use Cases

• Convert an A-share broker export into a candlestick review chart with real buy and sell markers.
• Visualize US stock, cryptocurrency, or futures fills against matching K-line data after a completed trade.
• Let Claude validate trade-review input before spending chart quota.
• Produce a consistent PNG artifact for a trading journal or post-trade review.
• Inspect API-key capabilities and remaining limits before starting a batch of review work.

Safety and Privacy

KLinePic is for post-trade visualization. It does not generate entry or exit signals, predict prices, provide investment advice, or place orders. Keep a human in the loop before any quota-consuming render and do not treat chart annotations as recommendations.

Tool requests can contain sensitive trading records, including instruments, timestamps, prices, quantities, directions, fees, and notes. Send only data you are permitted to process, keep the Agent API key outside source control, and review the MCP client's transcript, image, and log retention before using real broker or customer records. Leave KLINEPIC_BASE_URL unset to use the hosted KLinePic API. If you intentionally override it, use only a trusted HTTPS endpoint because the adapter sends both KLINE_AGENT_API_KEY and the full trade payload to that address.

Source Review

• https://github.com/sher1096/klinepic-agent-api-examples
• https://github.com/sher1096/klinepic-agent-api-examples/blob/master/README.md
• https://github.com/sher1096/klinepic-agent-api-examples/blob/master/llms-install.md
• https://github.com/sher1096/klinepic-agent-api-examples/blob/master/package.json
• https://github.com/sher1096/klinepic-agent-api-examples/blob/master/SECURITY.md
• https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sher1096%2Fklinepic/versions/latest

These sources were reviewed on 2026-07-13. Prefer the live repository, installation guide, package metadata, security policy, and official MCP Registry entry for current commands, versions, credentials, and tool behavior.

Duplicate Check

No KLinePic name, repository URL, io.github.sher1096/klinepic registry name, or dedicated post-trade candlestick review-chart MCP entry was found in HeyClaude content, open pull requests, or open issues before this submission.

Editorial Disclosure

This source-backed entry was submitted by the KLinePic repository owner. The adapter is public and MIT-licensed; API calls require a KLinePic Agent API key, preflight does not consume chart-render quota, and finished renders are subject to the account's plan and quota. There is no sponsorship or affiliate link in this entry.

• Source repositorygithub.com 2026-07-13T23:26:42-07:00
• Documentationgithub.com
• Websiteklinepic.com
• Submitted by sher10962026-07-13