# Prediction Market MCP

A legacy TypeScript MCP client that connects an MCP host to a separate prediction-market research API. Maintained by **King Made** as the source and support destination for the historical npm package `@kingmadellc/prediction-market-mcp@1.0.1`.

**Maintenance mode · experimental client · no automatic payments.**

## How it works

```mermaid
flowchart LR
    A[Your MCP host] -->|stdio| B[This client]
    B -->|HTTPS request| C[Separate hosted API]
    C --> D{Response}
    D -->|Success| E[JSON research output]
    D -->|HTTP 402| F[Payment-required information]
    E --> A
    F --> A
```

The repository contains the client, not the hosted service. It does not contain a wallet, sign a payment, place trades, or retry an HTTP 402 response with payment authorization. Requests send the supplied tool arguments to the external API configured in [`src/index.ts`](src/index.ts).

## Available tools

| Tool | Client request | Purpose |
| --- | --- | --- |
| `prediction_market_estimate` | `GET /api/estimate` | Request a probability estimate |
| `prediction_market_size` | `POST /api/size` | Request a sizing calculation |
| `prediction_market_scan` | `POST /api/scan` | Submit markets for ranking |
| `prediction_market_ensemble` | `POST /api/ensemble` | Request combined analysis |
| `prediction_market_info` | `GET /` | Read service information |

Service availability, paid execution, and previously advertised performance figures have not been validated end to end. The client includes historical price strings; use the actual service response for current requirements rather than treating those strings as an offer.

## Use the historical npm release

Requires **Node.js 18 or newer**, as declared in the package metadata. Repository CI uses Node.js 22.

For an MCP host that accepts a command and arguments, configure:

```json
{
  "mcpServers": {
    "prediction-market": {
      "command": "npx",
      "args": ["-y", "@kingmadellc/prediction-market-mcp@1.0.1"]
    }
  }
}
```

Alternatively, install the command globally:

```sh
npm install -g @kingmadellc/prediction-market-mcp@1.0.1
```

The published npm version is historical. Commits to this repository do not update it automatically. The stdio process is designed to be launched by an MCP host, not opened as a website.

## Develop locally

```sh
git clone https://github.com/kingmadellc/prediction-market-mcp.git
cd prediction-market-mcp
npm ci --ignore-scripts
npm run build
npm pack --dry-run
```

Point your MCP host at `node` with the absolute path to the resulting `dist/index.js` when testing your checkout. `npm run dev` starts the TypeScript entry point for development.

| Path | Purpose |
| --- | --- |
| `src/index.ts` | Tool definitions, API routing, and stdio server |
| `dist/index.js` | Compiled CLI entry point |
| `package.json` | Command, package metadata, and scripts |
| `.github/workflows/build.yml` | Build, package inspection, and dependency audit |

CI does not call the service or publish to npm. No live financial transaction is part of repository verification.

## Support and license

[Report reproducible client bugs](https://github.com/kingmadellc/prediction-market-mcp/issues), including the tool name and sanitized error output. Do not include credentials, wallet keys, account exports, or private financial data. No response-time commitment is offered for this legacy client.

[MIT license](LICENSE), matching the existing package declaration. Preserve the license notice when redistributing the client. The separate hosted API has its own service requirements.