# Okf Mcp

> Generic Model Context Protocol (MCP) server that discovers installed okf-* skill binaries and exposes their produce/ingest commands as MCP tools for any MCP-capable harness (Claude Code, Gemini CLI, etc.). Use when wiring OKF Skills into an agent over MCP instead of invoking each connector binary directly.

- **Type:** Skill
- **Install:** `agentstack add skill-xsavikx-okf-skills-okf-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [xSAVIKx](https://agentstack.voostack.com/s/xsavikx)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [xSAVIKx](https://github.com/xSAVIKx)
- **Source:** https://github.com/xSAVIKx/okf-skills/tree/master/okf-mcp
- **Website:** https://xsavikx.github.io/okf-skills/

## Install

```sh
agentstack add skill-xsavikx-okf-skills-okf-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# OKF MCP Server

`okf-mcp` is a generic [Model Context Protocol](https://modelcontextprotocol.io) server. On startup it discovers installed `okf-*` skill binaries, runs ` schema` on each, and exposes every skill command (except `schema` itself) as an MCP tool named `__` (e.g. `okf-sqlite__produce`). Any MCP-capable harness can then drive all of OKF Skills without per-skill glue.

## How it works

1. **Discovery** — scans `--skills-dir`, else `$OKF_SKILLS_DIR`, else every `$PATH` entry, for `okf-*` executables.
2. **Reflection** — reads each skill's machine-readable `schema` output and turns its flags into a JSON-Schema tool input.
3. **Invocation** — a tool call is translated back into the skill's CLI (` --flag value ...`) and run with a per-call timeout. Flags that advertise an `env` binding (e.g. database passwords) are passed via the child environment, never argv. The skill's stdout is returned as the tool result.

## Install

Install the published server binary (Go 1.24+) — no clone needed:

```bash
go install github.com/xSAVIKx/okf-skills/okf-mcp@v0.1.0
```

This drops an `okf-mcp` binary into `$(go env GOPATH)/bin`. Alternatively, build from a clone: `cd okf-mcp && go build -o okf-mcp .`

## Running

```bash
okf-mcp                      # discover skills on PATH, serve over stdio
okf-mcp --skills-dir ./bin   # discover skills in a specific directory
okf-mcp --timeout 2m         # per-invocation timeout (default 5m)
```

Diagnostics are written to stderr; stdout is the MCP protocol channel.

## Configuring a harness

Point any MCP client at the `okf-mcp` command over stdio. Example (generic MCP client config):

```json
{
  "mcpServers": {
    "okf": { "command": "okf-mcp", "args": ["--skills-dir", "/path/to/okf/bin"] }
  }
}
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [xSAVIKx](https://github.com/xSAVIKx)
- **Source:** [xSAVIKx/okf-skills](https://github.com/xSAVIKx/okf-skills)
- **License:** Apache-2.0
- **Homepage:** https://xsavikx.github.io/okf-skills/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xsavikx-okf-skills-okf-mcp
- Seller: https://agentstack.voostack.com/s/xsavikx
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.