Knoww

io.github.metatxnPublished by GitHub account metatxnv0.2.12Updated Nov 4, 2026

Read-only Polymarket search, market details, order books, price history, and market cards.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote, read-only MCP endpoint from Knoww that lets an assistant search Polymarket prediction markets and inspect market details, order books and price history.

What you can do
  • Search Polymarket markets and events by keyword or category such as Politics, Sports, Finance and Crypto
  • Read market details, including event and market views with price charts
  • Inspect order books and price history for a market
  • Retrieve market cards for display or comparison
  • All access is read-only; no trading or order placement is exposed.
When to use it
Useful when you want an assistant to look up prediction-market odds, compare markets, or pull current prices and order-book depth from Polymarket while researching or writing.
Requirements
A remote MCP endpoint at mcp.knoww.app over streamable HTTP; OAuth sign-in is required. No local runtime, packages, environment variables or headers are declared.
Before you install
Access requires an OAuth account with the provider, so your identity and usage are tied to that sign-in. Market data is third-party Polymarket content and may be delayed or incomplete; verify figures before relying on them. The README also describes wallet, paper-trading and admin features of the wider platform, but the MCP endpoint is described as read-only.

Installation

In SourceWeft

  1. Open Knoww in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.metatxn%2Fknoww/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "knoww": {
      "type": "http",
      "url": "https://mcp.knoww.app/mcp"
    }
  }
}

README

Knoww

A prediction markets platform to Know your Odds, powered by Polymarket.

Features

  • Real-time market data from Polymarket
  • Multi-wallet support via Reown AppKit
  • Browse by categories: Politics, Sports, Finance, Crypto
  • Event and market detail views with price charts
  • Internal paper-trading agent dashboard and admin APIs
  • Edge deployment on Cloudflare Workers

Quick Start

Prerequisites

If you plan to work on apps/agent, use a current Node.js release that supports node --experimental-strip-types for that package's test script.

Setup

bash
# Install dependenciespnpm install
# Seed the Next.js environment file used by `pnpm dev:web`cp apps/web/.env.local.example apps/web/.env.local
# Seed the Wrangler/Worker environment file used by `pnpm preview`# and by local Cloudflare-style bindings such as D1/cron varscp apps/web/.dev.vars.example apps/web/.dev.vars
# Add required local variables$EDITOR apps/web/.env.local# Add Worker/runtime variables when you need preview mode, agent admin flows,# or parity with Cloudflare bindings$EDITOR apps/web/.dev.vars# Required beyond the example file:# NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID## The example file already includes:# NEXT_PUBLIC_POLY_BUILDER_CODE# NEXT_PUBLIC_POLYMARKET_HOST# NEXT_PUBLIC_POLYMARKET_WS_HOST# NEXT_PUBLIC_POLYMARKET_CHAIN_ID# POLY_RELAYER_API_KEY# POLY_RELAYER_API_KEY_ADDRESS## Common optional vars for local parity:# NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN,# NEXT_PUBLIC_POSTHOG_HOST, POSTHOG_PROJECT_API_KEY, POSTHOG_HOST,# OPENROUTER_API_KEY, EXTENSION_SESSION_SECRET,# BUILDER_SIGNING_SERVER_URL, INTERNAL_AUTH_TOKEN,# ALCHEMY_API_KEY, POLYGON_RPC_URL, COINMARKET_API_KEY
# Run the web apppnpm dev:web

Open http://localhost:8000

pnpm dev:web reads apps/web/.env.local. pnpm preview and the Cloudflare Worker runtime read apps/web/.dev.vars, which is also where local D1/agent cron settings belong.

Extension Development

bash
# Configure the extension environmentcp apps/extension/.env.example apps/extension/.env
# Optional overrides:# DEV_MODE=false        # point the built extension at production# POLY_BUILDER_CODE=... # builder attribution code for extension orders# WALLETCONNECT_PROJECT_ID=... # required for WalletConnect/mobile wallet QR flows
# Run the web app locally for extension API callspnpm dev:web
# In a second terminal, run the extension build in watch modepnpm dev:ext

In development, the extension targets http://localhost:8000 by default. Use DEV_MODE=false in apps/extension/.env if you want the built extension to talk to production instead.

Tech Stack

CategoryTechnology
FrameworkNext.js 15 (App Router)
WalletReown AppKit, Wagmi, Viem
DataTanStack Query
UIShadcn, Tailwind CSS v4, Framer Motion
ToolingBiomeJS, TypeScript
DeploymentCloudflare Workers

Scripts

Root workspace scripts:

bash
pnpm dev:web        # Run the Next.js web app on port 8000pnpm dev:ext        # Run the extension build in watch modepnpm build          # Build all workspace packagespnpm build:web      # Build the web app onlypnpm build:ext      # Build the extension onlypnpm build:ext:dev  # Build the extension once in development modepnpm test           # Run workspace tests where definedpnpm preview        # Preview the Cloudflare web deployment locallypnpm lint           # Lint the monorepopnpm lint:web       # Lint the web app onlypnpm lint:ext       # Lint the extension onlypnpm format         # Format the monorepopnpm typecheck      # Type-check all workspace packagespnpm typecheck:web  # Type-check the web app onlypnpm typecheck:ext  # Type-check the extension onlypnpm audit:security # Run a high-severity dependency auditpnpm brand:render   # Render the brand mark assetpnpm deploy         # Deploy the web app to Cloudflarepnpm prepare        # Install Husky hookspnpm release:ext    # Bump, build, and zip the extension release

Package-level scripts live in the workspace packages:

  • apps/web/package.json: dev:turbo, start, soak, soak:assert, cf-typegen, agent:d1:list:local, agent:d1:adopt-runtime-schema:local, agent:d1:adopt-runtime-schema:remote, agent:d1:migrate:local, agent:d1:migrate:remote, test, test:node, test:watch, test:coverage, test:e2e
  • apps/extension/package.json: clean, test, test:scoring, benchmark:embeddings, format, version:bump, zip, release
  • apps/agent/package.json: build, typecheck, lint, format, test

Common test commands:

bash
pnpm --filter @knoww/web test           # Web Vitest suite + node-based testspnpm --filter @knoww/web test:watch     # Web Vitest watch modepnpm --filter @knoww/web test:coverage  # Web coverage runpnpm --filter @knoww/web test:e2e       # Web Playwright smoke testpnpm --filter @knoww/extension test     # Extension scoring testspnpm --filter @knoww/agent test         # Agent node tests

Documentation

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Run pnpm lint before submitting
  4. Open a pull request

License

AGPL-3.0

Built by Soclly

Source: README.md at commit 2638ccc

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

9
  1. v0.2.12LatestOct 21, 2026
  2. v0.2.10Oct 10, 2026
  3. v0.2.9Oct 8, 2026
  4. v0.2.8Sep 28, 2026
  5. v0.2.7Sep 27, 2026
  6. v0.2.6Sep 26, 2026
  7. v0.2.5Sep 24, 2026
  8. v0.2.4Sep 23, 2026
  9. v0.2.3Sep 22, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts