@hol-org/hashnet-mcp 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +133 -0
- package/README.md +251 -0
- package/deploy/Dockerfile +24 -0
- package/deploy/README.md +31 -0
- package/deploy/fly.toml +41 -0
- package/dist/cli/up.js +128 -0
- package/dist/cli/up.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +1946 -0
- package/dist/index.js.map +1 -0
- package/examples/agent-registration-request.json +48 -0
- package/examples/workflows/workflow.agentverseBridge.json +15 -0
- package/examples/workflows/workflow.chatSmoke.json +8 -0
- package/examples/workflows/workflow.discovery.json +4 -0
- package/examples/workflows/workflow.erc8004Discovery.json +4 -0
- package/examples/workflows/workflow.erc8004X402.json +87 -0
- package/examples/workflows/workflow.fullRegistration.json +73 -0
- package/examples/workflows/workflow.historyTopUp.json +14 -0
- package/examples/workflows/workflow.ledgerAuth.json +8 -0
- package/examples/workflows/workflow.openrouterChat.json +7 -0
- package/examples/workflows/workflow.opsCheck.json +3 -0
- package/examples/workflows/workflow.registerAgentAdvanced.json +84 -0
- package/examples/workflows/workflow.registerAgentErc8004.json +82 -0
- package/examples/workflows/workflow.registerMcp.json +71 -0
- package/examples/workflows/workflow.registryBrokerShowcase.json +6 -0
- package/examples/workflows/workflow.x402Registration.json +83 -0
- package/examples/workflows/workflow.x402TopUp.json +13 -0
- package/package.json +79 -0
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
{
|
|
2
|
+
"payload": {
|
|
3
|
+
"profile": {
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"type": 2,
|
|
6
|
+
"display_name": "Hashnet MCP Server",
|
|
7
|
+
"alias": "hashnet-mcp",
|
|
8
|
+
"bio": "FastMCP wrapper around the Hashgraph Online Registry Broker.",
|
|
9
|
+
"socials": [
|
|
10
|
+
{
|
|
11
|
+
"platform": "github",
|
|
12
|
+
"handle": "hashgraphonline"
|
|
13
|
+
}
|
|
14
|
+
],
|
|
15
|
+
"mcpServer": {
|
|
16
|
+
"version": "1.0.0",
|
|
17
|
+
"connectionInfo": {
|
|
18
|
+
"url": "https://hashnet.example.com/mcp/stream",
|
|
19
|
+
"transport": "sse"
|
|
20
|
+
},
|
|
21
|
+
"services": [
|
|
22
|
+
0,
|
|
23
|
+
1,
|
|
24
|
+
2,
|
|
25
|
+
6
|
|
26
|
+
],
|
|
27
|
+
"description": "Provides hol.* registry broker tooling over MCP.",
|
|
28
|
+
"capabilities": [
|
|
29
|
+
"registry-search",
|
|
30
|
+
"registration",
|
|
31
|
+
"uaid"
|
|
32
|
+
],
|
|
33
|
+
"resources": [
|
|
34
|
+
{
|
|
35
|
+
"name": "hol.search.help",
|
|
36
|
+
"description": "Search usage info"
|
|
37
|
+
}
|
|
38
|
+
],
|
|
39
|
+
"tools": [
|
|
40
|
+
{
|
|
41
|
+
"name": "hol.search",
|
|
42
|
+
"description": "Discover agents"
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"name": "hol.registerAgent",
|
|
46
|
+
"description": "Register new agent"
|
|
47
|
+
}
|
|
48
|
+
],
|
|
49
|
+
"maintainer": "hol",
|
|
50
|
+
"repository": "https://github.com/hol/hashnet-mcp",
|
|
51
|
+
"docs": "https://hashgraphonline.com/docs"
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
"protocol": "mcp",
|
|
55
|
+
"communicationProtocol": "sse",
|
|
56
|
+
"registry": "hashgraph-online",
|
|
57
|
+
"metadata": {
|
|
58
|
+
"trustScore": 95,
|
|
59
|
+
"verified": true,
|
|
60
|
+
"avgLatency": 120,
|
|
61
|
+
"uptime": 99.9,
|
|
62
|
+
"provider": "Hashnet",
|
|
63
|
+
"category": "infrastructure",
|
|
64
|
+
"adapter": "rb",
|
|
65
|
+
"openConvAICompatible": true,
|
|
66
|
+
"customFields": {
|
|
67
|
+
"region": "iad"
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
},
|
|
71
|
+
"additionalRegistrySelections": [
|
|
72
|
+
"agentverse:global",
|
|
73
|
+
"openrouter:global"
|
|
74
|
+
],
|
|
75
|
+
"updateAdditionalRegistries": [
|
|
76
|
+
"agentverse:testnet"
|
|
77
|
+
],
|
|
78
|
+
"creditTopUp": {
|
|
79
|
+
"accountId": "0.0.123456",
|
|
80
|
+
"privateKey": "302e020100300506032b657004220420YOUR_HEDERA_PRIVATE_KEY",
|
|
81
|
+
"hbarAmount": 1.25,
|
|
82
|
+
"memo": "workflow.registerAgentAdvanced sample"
|
|
83
|
+
}
|
|
84
|
+
}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
{
|
|
2
|
+
"payload": {
|
|
3
|
+
"profile": {
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"type": 2,
|
|
6
|
+
"display_name": "Hashnet MCP Server",
|
|
7
|
+
"alias": "hashnet-mcp",
|
|
8
|
+
"bio": "FastMCP wrapper around the Hashgraph Online Registry Broker.",
|
|
9
|
+
"socials": [
|
|
10
|
+
{
|
|
11
|
+
"platform": "github",
|
|
12
|
+
"handle": "hashgraphonline"
|
|
13
|
+
}
|
|
14
|
+
],
|
|
15
|
+
"mcpServer": {
|
|
16
|
+
"version": "1.0.0",
|
|
17
|
+
"connectionInfo": {
|
|
18
|
+
"url": "https://hashnet.example.com/mcp/stream",
|
|
19
|
+
"transport": "sse"
|
|
20
|
+
},
|
|
21
|
+
"services": [
|
|
22
|
+
0,
|
|
23
|
+
1,
|
|
24
|
+
2,
|
|
25
|
+
6
|
|
26
|
+
],
|
|
27
|
+
"description": "Provides hol.* registry broker tooling over MCP.",
|
|
28
|
+
"capabilities": [
|
|
29
|
+
"registry-search",
|
|
30
|
+
"registration",
|
|
31
|
+
"uaid"
|
|
32
|
+
],
|
|
33
|
+
"resources": [
|
|
34
|
+
{
|
|
35
|
+
"name": "hol.search.help",
|
|
36
|
+
"description": "Search usage info"
|
|
37
|
+
}
|
|
38
|
+
],
|
|
39
|
+
"tools": [
|
|
40
|
+
{
|
|
41
|
+
"name": "hol.search",
|
|
42
|
+
"description": "Discover agents"
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"name": "hol.registerAgent",
|
|
46
|
+
"description": "Register new agent"
|
|
47
|
+
}
|
|
48
|
+
],
|
|
49
|
+
"maintainer": "hol",
|
|
50
|
+
"repository": "https://github.com/hol/hashnet-mcp",
|
|
51
|
+
"docs": "https://hashgraphonline.com/docs"
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
"protocol": "mcp",
|
|
55
|
+
"communicationProtocol": "sse",
|
|
56
|
+
"registry": "hashgraph-online",
|
|
57
|
+
"metadata": {
|
|
58
|
+
"trustScore": 95,
|
|
59
|
+
"verified": true,
|
|
60
|
+
"avgLatency": 120,
|
|
61
|
+
"uptime": 99.9,
|
|
62
|
+
"provider": "Hashnet",
|
|
63
|
+
"category": "infrastructure",
|
|
64
|
+
"adapter": "rb",
|
|
65
|
+
"openConvAICompatible": true,
|
|
66
|
+
"customFields": {
|
|
67
|
+
"region": "iad"
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
},
|
|
71
|
+
"erc8004Networks": [
|
|
72
|
+
"erc-8004:mainnet",
|
|
73
|
+
"erc-8004:testnet"
|
|
74
|
+
],
|
|
75
|
+
"ledgerVerification": {
|
|
76
|
+
"challengeId": "challenge-demo",
|
|
77
|
+
"accountId": "0.0.123456",
|
|
78
|
+
"network": "testnet",
|
|
79
|
+
"signature": "SIGNATURE_PLACEHOLDER",
|
|
80
|
+
"signatureKind": "raw"
|
|
81
|
+
}
|
|
82
|
+
}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
{
|
|
2
|
+
"payload": {
|
|
3
|
+
"profile": {
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"type": 2,
|
|
6
|
+
"display_name": "Hashnet MCP Server",
|
|
7
|
+
"alias": "hashnet-mcp",
|
|
8
|
+
"bio": "FastMCP wrapper around the Hashgraph Online Registry Broker.",
|
|
9
|
+
"socials": [
|
|
10
|
+
{
|
|
11
|
+
"platform": "github",
|
|
12
|
+
"handle": "hashgraphonline"
|
|
13
|
+
}
|
|
14
|
+
],
|
|
15
|
+
"mcpServer": {
|
|
16
|
+
"version": "1.0.0",
|
|
17
|
+
"connectionInfo": {
|
|
18
|
+
"url": "https://hashnet.example.com/mcp/stream",
|
|
19
|
+
"transport": "sse"
|
|
20
|
+
},
|
|
21
|
+
"services": [
|
|
22
|
+
0,
|
|
23
|
+
1,
|
|
24
|
+
2,
|
|
25
|
+
6
|
|
26
|
+
],
|
|
27
|
+
"description": "Provides hol.* registry broker tooling over MCP.",
|
|
28
|
+
"capabilities": [
|
|
29
|
+
"registry-search",
|
|
30
|
+
"registration",
|
|
31
|
+
"uaid"
|
|
32
|
+
],
|
|
33
|
+
"resources": [
|
|
34
|
+
{
|
|
35
|
+
"name": "hol.search.help",
|
|
36
|
+
"description": "Search usage info"
|
|
37
|
+
}
|
|
38
|
+
],
|
|
39
|
+
"tools": [
|
|
40
|
+
{
|
|
41
|
+
"name": "hol.search",
|
|
42
|
+
"description": "Discover agents"
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"name": "hol.registerAgent",
|
|
46
|
+
"description": "Register new agent"
|
|
47
|
+
}
|
|
48
|
+
],
|
|
49
|
+
"maintainer": "hol",
|
|
50
|
+
"repository": "https://github.com/hol/hashnet-mcp",
|
|
51
|
+
"docs": "https://hashgraphonline.com/docs"
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
"protocol": "mcp",
|
|
55
|
+
"communicationProtocol": "sse",
|
|
56
|
+
"registry": "hashgraph-online",
|
|
57
|
+
"metadata": {
|
|
58
|
+
"trustScore": 95,
|
|
59
|
+
"verified": true,
|
|
60
|
+
"avgLatency": 120,
|
|
61
|
+
"uptime": 99.9,
|
|
62
|
+
"provider": "Hashnet",
|
|
63
|
+
"category": "infrastructure",
|
|
64
|
+
"adapter": "rb",
|
|
65
|
+
"openConvAICompatible": true,
|
|
66
|
+
"customFields": {
|
|
67
|
+
"region": "iad"
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
{
|
|
2
|
+
"payload": {
|
|
3
|
+
"profile": {
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"type": 2,
|
|
6
|
+
"display_name": "Hashnet MCP Server",
|
|
7
|
+
"alias": "hashnet-mcp",
|
|
8
|
+
"bio": "FastMCP wrapper around the Hashgraph Online Registry Broker.",
|
|
9
|
+
"socials": [
|
|
10
|
+
{
|
|
11
|
+
"platform": "github",
|
|
12
|
+
"handle": "hashgraphonline"
|
|
13
|
+
}
|
|
14
|
+
],
|
|
15
|
+
"mcpServer": {
|
|
16
|
+
"version": "1.0.0",
|
|
17
|
+
"connectionInfo": {
|
|
18
|
+
"url": "https://hashnet.example.com/mcp/stream",
|
|
19
|
+
"transport": "sse"
|
|
20
|
+
},
|
|
21
|
+
"services": [
|
|
22
|
+
0,
|
|
23
|
+
1,
|
|
24
|
+
2,
|
|
25
|
+
6
|
|
26
|
+
],
|
|
27
|
+
"description": "Provides hol.* registry broker tooling over MCP.",
|
|
28
|
+
"capabilities": [
|
|
29
|
+
"registry-search",
|
|
30
|
+
"registration",
|
|
31
|
+
"uaid"
|
|
32
|
+
],
|
|
33
|
+
"resources": [
|
|
34
|
+
{
|
|
35
|
+
"name": "hol.search.help",
|
|
36
|
+
"description": "Search usage info"
|
|
37
|
+
}
|
|
38
|
+
],
|
|
39
|
+
"tools": [
|
|
40
|
+
{
|
|
41
|
+
"name": "hol.search",
|
|
42
|
+
"description": "Discover agents"
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"name": "hol.registerAgent",
|
|
46
|
+
"description": "Register new agent"
|
|
47
|
+
}
|
|
48
|
+
],
|
|
49
|
+
"maintainer": "hol",
|
|
50
|
+
"repository": "https://github.com/hol/hashnet-mcp",
|
|
51
|
+
"docs": "https://hashgraphonline.com/docs"
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
"protocol": "mcp",
|
|
55
|
+
"communicationProtocol": "sse",
|
|
56
|
+
"registry": "hashgraph-online",
|
|
57
|
+
"metadata": {
|
|
58
|
+
"trustScore": 95,
|
|
59
|
+
"verified": true,
|
|
60
|
+
"avgLatency": 120,
|
|
61
|
+
"uptime": 99.9,
|
|
62
|
+
"provider": "Hashnet",
|
|
63
|
+
"category": "infrastructure",
|
|
64
|
+
"adapter": "rb",
|
|
65
|
+
"openConvAICompatible": true,
|
|
66
|
+
"customFields": {
|
|
67
|
+
"region": "iad"
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
},
|
|
71
|
+
"x402": {
|
|
72
|
+
"accountId": "0.0.123456",
|
|
73
|
+
"credits": 300,
|
|
74
|
+
"evmPrivateKey": "0xYOUR_EVM_PRIVATE_KEY",
|
|
75
|
+
"ledgerVerification": {
|
|
76
|
+
"challengeId": "challenge-demo",
|
|
77
|
+
"accountId": "0.0.123456",
|
|
78
|
+
"network": "testnet",
|
|
79
|
+
"signature": "SIGNED_LEDGER_CHALLENGE"
|
|
80
|
+
}
|
|
81
|
+
},
|
|
82
|
+
"chatMessage": "Ping after registration"
|
|
83
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
{
|
|
2
|
+
"accountId": "0.0.123456",
|
|
3
|
+
"credits": 250,
|
|
4
|
+
"description": "Sample X402 purchase",
|
|
5
|
+
"evmPrivateKey": "0xYOUR_EVM_PRIVATE_KEY",
|
|
6
|
+
"network": "base-sepolia",
|
|
7
|
+
"ledgerVerification": {
|
|
8
|
+
"challengeId": "challenge-demo",
|
|
9
|
+
"accountId": "0.0.123456",
|
|
10
|
+
"network": "testnet",
|
|
11
|
+
"signature": "SIGNED_LEDGER_CHALLENGE"
|
|
12
|
+
}
|
|
13
|
+
}
|
package/package.json
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@hol-org/hashnet-mcp",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "FastMCP server exposing Hashgraph Online Registry Broker tooling.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./dist/index.js",
|
|
7
|
+
"module": "./dist/index.js",
|
|
8
|
+
"types": "./dist/index.d.ts",
|
|
9
|
+
"exports": {
|
|
10
|
+
".": {
|
|
11
|
+
"types": "./dist/index.d.ts",
|
|
12
|
+
"import": "./dist/index.js",
|
|
13
|
+
"default": "./dist/index.js"
|
|
14
|
+
},
|
|
15
|
+
"./cli/up": {
|
|
16
|
+
"import": "./dist/cli/up.js",
|
|
17
|
+
"default": "./dist/cli/up.js"
|
|
18
|
+
}
|
|
19
|
+
},
|
|
20
|
+
"bin": {
|
|
21
|
+
"hashnet-mcp": "./dist/cli/up.js"
|
|
22
|
+
},
|
|
23
|
+
"files": [
|
|
24
|
+
"dist",
|
|
25
|
+
"deploy",
|
|
26
|
+
"examples",
|
|
27
|
+
"README.md",
|
|
28
|
+
"AGENTS.md",
|
|
29
|
+
"todo.md"
|
|
30
|
+
],
|
|
31
|
+
"scripts": {
|
|
32
|
+
"dev:stdio": "MCP_TRANSPORT=stdio tsx src/index.ts",
|
|
33
|
+
"dev:sse": "tsx src/index.ts",
|
|
34
|
+
"build": "tsup --config tsup.config.ts",
|
|
35
|
+
"start": "node dist/index.js",
|
|
36
|
+
"quickstart": "tsx scripts/quickstart.ts",
|
|
37
|
+
"test": "vitest",
|
|
38
|
+
"test:run": "vitest run",
|
|
39
|
+
"test:coverage": "vitest run --coverage",
|
|
40
|
+
"test:tools": "tsx scripts/run-tool-suite.ts --spawn",
|
|
41
|
+
"test:tools:mock": "tsx scripts/run-tool-suite.ts --mock",
|
|
42
|
+
"workflow:list": "tsx scripts/list-workflows.ts",
|
|
43
|
+
"workflow:run": "tsx scripts/run-workflow.ts",
|
|
44
|
+
"workflow:register": "tsx scripts/workflow-register.ts",
|
|
45
|
+
"workflow:register:advanced": "tsx scripts/workflow-register-advanced.ts",
|
|
46
|
+
"workflow:register:erc8004": "tsx scripts/workflow-register-erc8004.ts",
|
|
47
|
+
"mock:broker": "tsx scripts/mock-broker.ts",
|
|
48
|
+
"claude:install": "tsx scripts/install-claude-code.ts",
|
|
49
|
+
"cursor:install": "tsx scripts/install-cursor.ts"
|
|
50
|
+
},
|
|
51
|
+
"keywords": [],
|
|
52
|
+
"author": "",
|
|
53
|
+
"license": "ISC",
|
|
54
|
+
"engines": {
|
|
55
|
+
"node": ">=18"
|
|
56
|
+
},
|
|
57
|
+
"packageManager": "pnpm@10.10.0",
|
|
58
|
+
"devDependencies": {
|
|
59
|
+
"@types/node": "^24.10.0",
|
|
60
|
+
"@vitest/coverage-v8": "^2.1.4",
|
|
61
|
+
"tsup": "^8.5.0",
|
|
62
|
+
"tsx": "^4.20.6",
|
|
63
|
+
"typescript": "^5.9.3",
|
|
64
|
+
"vitest": "^2.1.4"
|
|
65
|
+
},
|
|
66
|
+
"dependencies": {
|
|
67
|
+
"@hashgraphonline/standards-sdk": "^0.1.128",
|
|
68
|
+
"@hono/node-server": "^1.19.6",
|
|
69
|
+
"@modelcontextprotocol/sdk": "^1.21.1",
|
|
70
|
+
"bottleneck": "^2.19.5",
|
|
71
|
+
"dotenv": "^17.2.3",
|
|
72
|
+
"fastmcp": "^3.22.0",
|
|
73
|
+
"hono": "^4.10.5",
|
|
74
|
+
"ioredis": "^5.8.2",
|
|
75
|
+
"pino": "^10.1.0",
|
|
76
|
+
"undici": "^7.16.0",
|
|
77
|
+
"zod": "^4.1.12"
|
|
78
|
+
}
|
|
79
|
+
}
|