1. Conduid
  2. Developer Tools
  3. Konkin
MCP server · Developer Tools

Konkin

by · github.com/otherfren/konkin

konkin mcp server - Keeper of Nodes, Keys, and Independent Networks

Unclaimed devtools
InstallView source
34Low

Scored 7 months ago · breakdown

About Konkin

Konkin is an MCP server published by otherfren in the Developer Tools category: konkin mcp server - Keeper of Nodes, Keys, and Independent Networks.

The repository has 2 stars and 0 forks, with the last commit 5 months ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/otherfren/konkin

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Konkin

Powered by Claude · Grounded in docs

I know everything about Konkin. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

Build Coverage Branches

** DISCLAIMER **

This is a hobby project — no guarantees! If you find bugs, please report them to me.

** DISCLAIMER **

Konkin.io

MCP crypto wallet wrapper for AI agents.

  • Interact with blockchains via natural language.
  • Keep secret keys hidden from your agents.
  • Supports 2FA via Telegram/other auth agents.

Docker installation helper script

  ./scripts/konkin-docker.sh

(Alternative) Agentic Installation without docker

Give this Installation Guide to your agent. He will guide you through the installation process.

Quick Start for developers

Requires: Java 21+, Maven 3.9+, at least one crypto wallet daemon.

mvn clean install
java -jar target/konkin-server-1.0.0.jar config.toml

On first run, secrets are auto-generated under ./secrets/ and credentials are printed to stdout. Copy them — cleartext secrets are only shown once BUT you can rotate them afterward in the web-ui.

You can change the folder for auto-generated secret files via server.secrets-dir in config.toml (defaults to ./secrets).

Configure

Edit config.toml in the working directory. Defaults work out of the box (H2 database, no external services).

Section Default Purpose
[server] 127.0.0.1:7070 Web UI + REST API
[agents.primary] 127.0.0.1:9550 Driver MCP server (your AI)
[agents.secondary.*] 9560, 9561 Auth MCP servers (approval flow)
[coins.*] btc, ltc, xmr Enabled coins and auth rules

Connect Claude Agent

  1. Read credentials from ./secrets/agent-primary.secret

  2. Get a bearer token:

    curl -s -X POST "http://127.0.0.1:9550/oauth/token" \
-d "grant_type=client_credentials" \
-d "client_id=konkin-primary" \
-d "client_secret=YOUR_SECRET"

    Tokens don't expire. Max 2 active per agent; a 3rd evicts the oldest.

  3. Register with Claude Code:

    claude mcp add --transport sse \
-H "Authorization: Bearer YOUR_BEARER_TOKEN" \
-s project \
konkin "http://127.0.0.1:9550/sse"

For other agents, refer to their MCP documentation.

Verify

  • Web UI: http://127.0.0.1:7070
  • Health: http://127.0.0.1:7070/api/v1/health
  • MCP SSE: http://127.0.0.1:9550/sse

Troubleshooting

Problem Fix
401 Unauthorized Re-issue token via /oauth/token and update settings.
NOT_READY Check config.toml and ./secrets/ for missing coin config or secrets.
MCP not showing in Claude Verify .mcp.json is valid. Restart Claude Code.
429 rate_limited Wait 60s, retry with correct credentials.
Agent using curl instead of MCP See documents/SKILL-driver-agent.md — agents must use MCP primitives only.

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Konkin

How do I install Konkin?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Konkin safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Konkin still maintained?

Yes — the last commit was 5 months ago. The repository has 2 stars and 0 forks.