Private API Documentation

# Add hash recovery tasks
curl -sS -X POST "https://api.onlinehashcrack.com/v2" \
	-H "Content-Type: application/json" \
	-d '{
		"api_key": "sk_REPLACE_WITH_YOUR_KEY",
		"agree_terms": "yes",
		"action": "add_tasks",
		"algo_mode": 0,
		"hashes": [
			"8124BC0A5335C27F086F24BA2C7A4810"
		]
	}'

# List current tasks
curl -sS -X POST "https://api.onlinehashcrack.com/v2" \
	-H "Content-Type: application/json" \
	-d '{
		"api_key": "sk_REPLACE_WITH_YOUR_KEY",
		"agree_terms": "yes",
		"action": "list_tasks"
	}'

# Identify the algo_mode(s) matching one or more hashes
curl -sS -X POST "https://api.onlinehashcrack.com/v2" \
	-H "Content-Type: application/json" \
	-d '{
		"api_key": "sk_REPLACE_WITH_YOUR_KEY",
		"agree_terms": "yes",
		"action": "identify_hash",
		"hashes": [
			"8124BC0A5335C27F086F24BA2C7A4810"
		]
	}'

# List your uploaded wordlists and storage quota
curl -sS -X POST "https://api.onlinehashcrack.com/v2" \
	-H "Content-Type: application/json" \
	-d '{
		"api_key": "sk_REPLACE_WITH_YOUR_KEY",
		"agree_terms": "yes",
		"action": "list_wordlists"
	}'

# Inspect the request schema
curl -sS "https://api.onlinehashcrack.com/v2?schema=1"

# Inspect the OpenAPI 3.0 schema
curl -sS "https://api.onlinehashcrack.com/v2?openapi=1"

import requests

url = "https://api.onlinehashcrack.com/v2"
payload = {
	"api_key": "sk_REPLACE_WITH_YOUR_KEY",
	"agree_terms": "yes",
	"action": "add_tasks",
	"algo_mode": 0,
	"hashes": ["8124BC0A5335C27F086F24BA2C7A4810"],
}

response = requests.post(url, json=payload, timeout=30)
data = response.json()

if response.status_code == 429:
	print("Retry after", response.headers.get("Retry-After"), "seconds")
elif not response.ok:
	print(data.get("error_code"), data.get("message"), data.get("request_id"))
else:
	print(data)

const response = await fetch('https://api.onlinehashcrack.com/v2', {
	method: 'POST',
	headers: { 'Content-Type': 'application/json' },
	body: JSON.stringify({
		api_key: 'sk_REPLACE_WITH_YOUR_KEY',
		agree_terms: 'yes',
		action: 'add_tasks',
		algo_mode: 0,
		hashes: ['8124BC0A5335C27F086F24BA2C7A4810'],
	}),
});

const data = await response.json();

if (response.status === 429) {
	console.log('Retry after', response.headers.get('Retry-After'), 'seconds');
} else if (!response.ok) {
	console.error(data.error_code, data.message, data.request_id);
} else {
	console.log(data);
}

$uri = 'https://api.onlinehashcrack.com/v2'
$payload = @{
	api_key = 'sk_REPLACE_WITH_YOUR_KEY'
	agree_terms = 'yes'
	action = 'add_tasks'
	algo_mode = 0
	hashes = @('8124BC0A5335C27F086F24BA2C7A4810')
} | ConvertTo-Json -Depth 4

try {
	$response = Invoke-RestMethod `
		-Uri $uri `
		-Method Post `
		-ContentType 'application/json' `
		-Body $payload `
		-TimeoutSec 30

	$response
} catch {
	$statusCode = $_.Exception.Response.StatusCode.value__
	$retryAfter = $_.Exception.Response.Headers['Retry-After']
	Write-Error "OHC API error HTTP $statusCode. Retry-After: $retryAfter"
}

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"time"
)

func main() {
	payload := map[string]any{
		"api_key": "sk_REPLACE_WITH_YOUR_KEY",
		"agree_terms": "yes",
		"action": "add_tasks",
		"algo_mode": 0,
		"hashes": []string{"8124BC0A5335C27F086F24BA2C7A4810"},
	}

	body, err := json.Marshal(payload)
	if err != nil {
		panic(err)
	}

	client := &http.Client{Timeout: 30 * time.Second}
	req, err := http.NewRequest(http.MethodPost, "https://api.onlinehashcrack.com/v2", bytes.NewReader(body))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")

	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	responseBody, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}

	if resp.StatusCode == http.StatusTooManyRequests {
		fmt.Println("Retry after", resp.Header.Get("Retry-After"), "seconds")
	}
	if resp.StatusCode >= 400 {
		fmt.Println("API error:", resp.Status, string(responseBody))
		return
	}

	fmt.Println(string(responseBody))
}

$url = 'https://api.onlinehashcrack.com/v2';
$payload = [
	'api_key' => 'sk_REPLACE_WITH_YOUR_KEY',
	'agree_terms' => 'yes',
	'action' => 'add_tasks',
	'algo_mode' => 0,
	'hashes' => ['8124BC0A5335C27F086F24BA2C7A4810'],
];

$ch = curl_init($url);
curl_setopt_array($ch, [
	CURLOPT_POST => true,
	CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
	CURLOPT_POSTFIELDS => json_encode($payload, JSON_THROW_ON_ERROR),
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_TIMEOUT => 30,
]);

$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$error = curl_error($ch);
curl_close($ch);

if ($body === false) {
	throw new RuntimeException('API request failed: ' . $error);
}

$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if ($status >= 400) {
	error_log('OHC API error ' . ($data['error_code'] ?? 'unknown') . ' request_id=' . ($data['request_id'] ?? 'none'));
}

print_r($data);

Three ways to connect Claude to your OHC account — all use the same URL.

Option 1 — Claude Code (recommended for developers)

Register the server once. Claude Code persists it across sessions.

claude mcp add onlinehashcrack \
    --transport http \
    "https://mcp.onlinehashcrack.com/sk_YOUR_API_KEY"

Confirm the server is registered:

claude mcp list

Then just open a session and ask:

claude
# → "List my OHC tasks" or "Submit this hash ..."

Option 2 — Claude Desktop

Open claude_desktop_config.json and add the entry under mcpServers. Create the file if it does not exist.

{
    "mcpServers": {
        "onlinehashcrack": {
            "url": "https://mcp.onlinehashcrack.com/sk_YOUR_API_KEY"
        }
    }
}

Restart Claude Desktop. The OHC tools will appear in the tool picker.

Option 3 — Claude.ai (web)

Go to Settings → Integrations, click Add integration, and paste the MCP URL:

https://mcp.onlinehashcrack.com/sk_YOUR_API_KEY

No restart needed — tools are available immediately in the next conversation.

ChatGPT Desktop and the OpenAI Agents SDK both support MCP remote servers.

Option 1 — ChatGPT Desktop

Open Settings → Connections and add the OHC MCP server by pasting the URL directly into the remote server field:

https://mcp.onlinehashcrack.com/sk_YOUR_API_KEY

Option 2 — OpenAI Agents SDK

Use the OHC MCP server inside an agent workflow. Install with pip install openai-agents.

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    params = {"url": "https://mcp.onlinehashcrack.com/sk_YOUR_API_KEY"}
    async with MCPServerStreamableHttp(name="OnlineHashCrack", params=params) as ohc:
        agent = Agent(
            name="hash-auditor",
            instructions=(
                "You are a security audit assistant with access to OnlineHashCrack. "
                "Only submit hashes the user confirms they own or are authorized to test."
            ),
            mcp_servers=[ohc],
        )
        result = await Runner.run(agent, "List my cracking tasks and summarize the results.")
        print(result.final_output)

asyncio.run(main())

See the OpenAI Agents SDK docs for streaming, tool filtering, and multi-server setups.