Konseki MCP
OfficialThe Konseki MCP server provides AI agents with access to pre-computed historical market context data for global equities via the Konseki public API, acting as a direct wrapper that returns raw JSON without interpretation.
Fetch metadata (
get_konseki_metadata): Retrieve raw metadata JSON from the Konseki API, including available countries and configuration details. No input parameters required.List supported symbols (
list_konseki_symbols): Retrieve a raw list of supported equity symbols available through the Konseki API. No input parameters required.Get market analysis (
get_konseki_analysis): Fetch raw historical market context analysis for a specific stock by providing thesymbol(e.g., "AAPL"),exchange(e.g., "NASDAQ"), andlookbackperiod. Supported lookback values:5,10,15,20,25,30,40, or50days. Returns historical analogs, pattern-match data, outcome distributions, and match-quality scores.
All tools return raw JSON directly from the Konseki public API — the client or downstream application is responsible for interpreting the data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Konseki MCP Show me market context for AAPL on NASDAQ with 15 days lookback"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Konseki MCP
Official Model Context Protocol server for Konseki.
Konseki is a pre-computed historical market context API for global equities, built for AI trading and quants. It matches current market conditions against historical analogs and returns structured pattern-match data, outcome distributions, and match-quality scores, grounding an AI agent's reasoning in evidence rather than generic commentary.
Konseki MCP is a direct wrapper around the Konseki public API. It lets AI agents and AI trading tools call Konseki endpoints through MCP tools while preserving the raw API response JSON for the user or downstream application to interpret.
Published package: @konseki/mcp
Requirements
Node.js 20 or newer.
A Konseki API key.
Get an API key from konseki.io.
Related MCP server: Alpha Vantage MCP Server
Design Principles
Direct API wrapper: the MCP server fetches Konseki API responses and returns them without interpretation.
User-owned interpretation: users, builders, and downstream AI clients decide how to analyze or summarize the returned JSON.
Public API only: the server uses
X-API-Keyagainst documented Konseki endpoints.No internal credentials: non-public service or operational credentials are never required for this package.
Configuration
The server reads configuration from environment variables:
KONSEKI_API_KEY=ks_live_your_api_keyDo not commit real API keys.
Intended Architecture
AI client
|
v
Konseki MCP server
|
v
Konseki public API
|
v
Raw historical market context JSONThe MCP server should not bypass Konseki public API behavior. It should behave like any other public API client.
Tools
get_konseki_metadata
Fetches raw JSON from GET /v1/metadata?country={country}.
Input:
{
"country": "US"
}list_konseki_countries
Fetches raw JSON from GET /v1/countries.
Input: none.
list_konseki_symbols
Fetches raw JSON from GET /v1/symbols?country={country}.
Input:
{
"country": "US"
}get_konseki_analysis
Fetches raw JSON from GET /v1/analysis/{symbol}-{exchange}?country={country}&lookback={lookback}.
Input:
{
"country": "US",
"symbol": "AAPL",
"exchange": "NASDAQ",
"lookback": 15
}Supported lookback values: 5, 10, 15, 20, 25, 30, 40, 50.
Response Compression
The server requests gzip-compressed API responses and decompresses them locally before returning JSON to the MCP client. This is handled automatically; users do not need to configure compression.
Installation
Use the published npm package through an MCP client with npx:
{
"mcpServers": {
"konseki": {
"command": "npx",
"args": ["-y", "@konseki/mcp"],
"env": {
"KONSEKI_API_KEY": "ks_live_your_api_key"
}
}
}
}This is the recommended configuration for users who want the official released package from npm.
Local Development
For development from this checkout, install dependencies, build the package, and configure your MCP client to run the built server:
npm install
npm run build{
"mcpServers": {
"konseki": {
"command": "node",
"args": ["/absolute/path/to/konseki-mcp/dist/index.js"],
"env": {
"KONSEKI_API_KEY": "ks_live_your_api_key"
}
}
}
}Development
Install dependencies:
npm installRun verification:
npm run typecheck
npm test
npm run buildSecurity
Never commit real API keys.
Never log raw API keys.
Never include user credentials in test snapshots or examples.
Use fake keys in documentation and tests.
Available Tools
3 toolsget_konseki_analysisGet Konseki AnalysisC
Fetch raw analysis JSON for a symbol, exchange, and lookback from the Konseki public API.
Inputs: symbol (required), exchange (required), lookback (required).
get_konseki_metadataGet Konseki MetadataB
Fetch raw metadata JSON from the Konseki public API.
Inputs: no named parameters.
list_konseki_symbolsList Konseki SymbolsA
Fetch raw supported symbols JSON from the Konseki public API.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct data type: analysis data, metadata, and supported symbols. There is no overlap in their purposes, making it clear which tool to use for a given retrieval task.
All tool names follow a consistent verb_noun_konseki pattern: 'get_konseki_analysis', 'get_konseki_metadata', and 'list_konseki_symbols'. The use of 'get' for single items and 'list' for collections is appropriate and predictable.
With 3 tools, the server is slightly on the low end but still well-scoped for a focused API wrapper that provides read-only access to three core data types. Each tool serves a clear purpose without unnecessary bloat.
The tools cover the main retrieval operations for the Konseki API: analysis, metadata, and symbol listing. Minor gaps might include filtering or parameterized queries, but the set is complete for basic data access needs.
Maintenance
Related MCP Connectors
Live crypto, DeFi, stock and web data plus datasets for agents. Pay per call with x402. No API key.
Market data and analytics for external AI clients
Live context for your agent: competitors, mentions and markets, from public data.
Market data for agents: token prices, DeFi TVL and DEX volume, perp funding, FX, yields, SEC data.
Related MCP Servers
- AlicenseAqualityBmaintenanceRead-only Hyperliquid market data for AI agents: trades, liquidations, funding, open interest, candles, wallet analytics and SQL over every fill since May 2025. 36 tools, hosted, no install, no key needed.4462,595 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables LLMs and agentic workflows to access real-time and historical stock market data through the Model Context Protocol.227MIT
- FlicenseNot gradedqualityCmaintenanceLets AI agents query real Kalshi market data by searching markets, retrieving market details, and reading order books, using only public GET requests with no Kalshi account or API keys.-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to query live pricing, resale, company KYC, SEC filings, patents, trademarks, public tenders, auctions and related market intelligence through MCP, returning clean typed JSON from primary sources on a pay-per-result basis.MIT