# Kalshi Kernel (oci · ghcr.io/copyleftdev/kalshi-kernel:0.1.1)

Unofficial safety-focused MCP server for Kalshi market data and explicitly authorized trading

- Trust score: 40/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-22

## Components

- oci · `ghcr.io/copyleftdev/kalshi-kernel:0.1.1`: 40/100 (this document), [markdown](https://verifymcp.io/servers/copyleftdev-kalshi-kernel/ghcr-io-copyleftdev-kalshi-kernel-0-1-1.md), [page](https://verifymcp.io/servers/copyleftdev-kalshi-kernel/ghcr-io-copyleftdev-kalshi-kernel-0-1-1)

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/copyleftdev/kalshi-kernel:0.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-22.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - Known CVEs could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
  - Install-script risk not yet assessed.
  - Dependency health could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 0 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 76/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1034 tokens (~129/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 2 categories.** Categories scored 0 because we could not verify them: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add copyleftdev-kalshi-kernel -- docker run --rm -i ghcr.io/copyleftdev/kalshi-kernel:0.1.1
```

### Codex

```bash
codex mcp add copyleftdev-kalshi-kernel -- docker run --rm -i ghcr.io/copyleftdev/kalshi-kernel:0.1.1
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "copyleftdev-kalshi-kernel": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/copyleftdev/kalshi-kernel:0.1.1"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  copyleftdev-kalshi-kernel:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/copyleftdev/kalshi-kernel:0.1.1"]
```

### Other

```json
{
  "mcpServers": {
    "copyleftdev-kalshi-kernel": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/copyleftdev/kalshi-kernel:0.1.1"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-22 (score 40)

First indexed and scored.

## MCP tools (8)

### `amend_order` (~201 tokens)

Amend the price and/or maximum fillable quantity of an existing live or paper order.

Input parameters:

- `client_order_id` (string): Existing client order identifier.
- `count` (string, required): Desired total maximum fillable quantity; pass the existing value when changing only price.
- `order_id` (string, required): Exchange or paper order identifier.
- `price` (string, required): Desired fixed-point dollar price; pass the existing value when changing only quantity.
- `product` (string, required): Product family containing the order. Allowed values: event, perp.
- `side` (string, required): Existing single-book order side required by the upstream amend operation. Allowed values: bid, ask.
- `subaccount` (integer): Kalshi subaccount number; defaults to the primary account. Minimum: 0. Maximum: 63.
- `ticker` (string, required): Exact market ticker used for routing and validation.
- `updated_client_order_id` (string): New idempotency identifier for the amended order.

Output parameters:

- `data` (object)
- `error` (null|object)
- `mode` (string)
- `ok` (boolean)

### `cancel_order` (~95 tokens)

Cancel the remaining quantity of one live or paper order.

Input parameters:

- `order_id` (string, required): Exchange or paper order identifier.
- `product` (string, required): Product family containing the order. Allowed values: event, perp.
- `subaccount` (integer): Kalshi subaccount number; defaults to the primary account. Minimum: 0. Maximum: 63.
- `ticker` (string, required): Exact market ticker used for routing and validation.

Output parameters:

- `data` (object)
- `error` (null|object)
- `mode` (string)
- `ok` (boolean)

### `get_market` (~54 tokens)

Get the authoritative metadata and current status for one event-contract or perpetual market.

Input parameters:

- `product` (string, required): Product family containing the ticker. Allowed values: event, perp.
- `ticker` (string, required): Exact Kalshi market ticker.

Output parameters:

- `data` (object)
- `error` (null|object)
- `mode` (string)
- `ok` (boolean)

### `get_orderbook` (~82 tokens)

Get the locally reconciled order book for one market, including freshness and sequence metadata.

Input parameters:

- `depth` (integer): Maximum price levels to return on each side. Minimum: 1. Maximum: 100.
- `product` (string, required): Product family containing the ticker. Allowed values: event, perp.
- `ticker` (string, required): Exact Kalshi market ticker.

Output parameters:

- `data` (object)
- `error` (null|object)
- `mode` (string)
- `ok` (boolean)

### `get_portfolio` (~75 tokens)

Return balances, positions, resting orders, and recent fills from the selected live or paper ledger.

Input parameters:

- `product` (string, required): Product family to report. Allowed values: event, perp.
- `subaccount` (integer): Kalshi subaccount number; defaults to the primary account. Minimum: 0. Maximum: 63.

Output parameters:

- `data` (object)
- `error` (null|object)
- `mode` (string)
- `ok` (boolean)

### `kernel_status` (~32 tokens)

Report the immutable execution mode, backend readiness, market-data freshness, and enabled capabilities. Call this before any trading operation.

Output parameters:

- `data` (object)
- `error` (null|object)
- `mode` (string)
- `ok` (boolean)

### `place_order` (~292 tokens)

Validate and place one order through the configured execution backend. In paper mode this can only affect the local simulated ledger.

Input parameters:

- `cancel_order_on_pause` (boolean): Cancel the resting order if exchange trading pauses.
- `client_order_id` (string): Stable caller-provided idempotency identifier. The kernel generates one when omitted.
- `count` (string, required): Fixed-point contract quantity encoded as a decimal string.
- `expiration_time` (integer): Optional Unix time in seconds; only valid with good_till_canceled.
- `post_only` (boolean): Reject rather than immediately take liquidity.
- `price` (string, required): Fixed-point dollar price encoded as a decimal string.
- `product` (string, required): Product family containing the market. Allowed values: event, perp.
- `reduce_only` (boolean): Prevent the order from increasing exposure.
- `self_trade_prevention_type` (string, required): Exchange self-trade prevention policy. Allowed values: taker_at_cross, maker.
- `side` (string, required): Single-book order side. Allowed values: bid, ask.
- `subaccount` (integer): Kalshi subaccount number; defaults to the primary account. Minimum: 0. Maximum: 63.
- `ticker` (string, required): Exact Kalshi market ticker.
- `time_in_force` (string, required): Exchange time-in-force policy. Allowed values: fill_or_kill, good_till_canceled, immediate_or_cancel.

Output parameters:

- `data` (object)
- `error` (null|object)
- `mode` (string)
- `ok` (boolean)

### `search_markets` (~141 tokens)

Find event-contract or perpetual markets using structured filters. Returns compact summaries suitable for choosing a ticker.

Input parameters:

- `cursor` (string): Pagination cursor returned by a previous call.
- `event_ticker` (string): Restrict event contracts to one event.
- `limit` (integer): Maximum number of markets to return. Minimum: 1. Maximum: 1000.
- `product` (string, required): Product family to search. Allowed values: event, perp.
- `series_ticker` (string): Restrict event contracts to one series.
- `status` (string): Exchange market status filter.
- `tickers` (array): Exact market tickers to include.

Output parameters:

- `data` (object)
- `error` (null|object)
- `mode` (string)
- `ok` (boolean)

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/copyleftdev-kalshi-kernel/ghcr-io-copyleftdev-kalshi-kernel-0-1-1#diagnostics

## Score history

- 2026-08-22: 40

## Links

- Repository: https://github.com/copyleftdev/kalshi-kernel
- Changelog RSS feed: https://verifymcp.io/servers/copyleftdev-kalshi-kernel/ghcr-io-copyleftdev-kalshi-kernel-0-1-1.xml
- Changelog JSON feed: https://verifymcp.io/servers/copyleftdev-kalshi-kernel/ghcr-io-copyleftdev-kalshi-kernel-0-1-1.json
- HTML version of this page: https://verifymcp.io/servers/copyleftdev-kalshi-kernel/ghcr-io-copyleftdev-kalshi-kernel-0-1-1