@blurt-blockchain/blurt-mcp-server 0.4.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.
Files changed (66) hide show
  1. package/CHANGELOG.md +118 -0
  2. package/LICENSE +682 -0
  3. package/README.md +117 -0
  4. package/SECURITY.md +107 -0
  5. package/dist/app.js +88 -0
  6. package/dist/buildServer.js +146 -0
  7. package/dist/contracts/registerBlurtTool.js +53 -0
  8. package/dist/contracts/toolRegistry.js +384 -0
  9. package/dist/resources/blurtResource.js +82 -0
  10. package/dist/server-stdio.js +37 -0
  11. package/dist/server.js +35 -0
  12. package/dist/tools/claimRewards.js +48 -0
  13. package/dist/tools/comment.js +58 -0
  14. package/dist/tools/compareAccounts.js +50 -0
  15. package/dist/tools/fetch.js +91 -0
  16. package/dist/tools/follow.js +39 -0
  17. package/dist/tools/getAccount.js +80 -0
  18. package/dist/tools/getAccountHistory.js +109 -0
  19. package/dist/tools/getAccountNotifications.js +40 -0
  20. package/dist/tools/getAccountPosts.js +130 -0
  21. package/dist/tools/getAccountRelationships.js +34 -0
  22. package/dist/tools/getAccountSubscriptions.js +50 -0
  23. package/dist/tools/getAccountWitnessVotes.js +46 -0
  24. package/dist/tools/getBlurtPrice.js +43 -0
  25. package/dist/tools/getChainStatus.js +94 -0
  26. package/dist/tools/getCommunity.js +75 -0
  27. package/dist/tools/getDelegations.js +37 -0
  28. package/dist/tools/getPendingRewards.js +53 -0
  29. package/dist/tools/getPost.js +88 -0
  30. package/dist/tools/getPostReblogs.js +29 -0
  31. package/dist/tools/getPostVotes.js +78 -0
  32. package/dist/tools/getPublications.js +109 -0
  33. package/dist/tools/getReferrals.js +39 -0
  34. package/dist/tools/getVoteValue.js +67 -0
  35. package/dist/tools/getWitness.js +46 -0
  36. package/dist/tools/listCommunities.js +90 -0
  37. package/dist/tools/listWitnesses.js +48 -0
  38. package/dist/tools/lookupAccounts.js +30 -0
  39. package/dist/tools/mute.js +39 -0
  40. package/dist/tools/post.js +42 -0
  41. package/dist/tools/readNotifications.js +35 -0
  42. package/dist/tools/reblog.js +39 -0
  43. package/dist/tools/search.js +189 -0
  44. package/dist/tools/subscribeCommunity.js +39 -0
  45. package/dist/tools/upvote.js +48 -0
  46. package/dist/utils/blurtUri.js +61 -0
  47. package/dist/utils/loadEnv.js +21 -0
  48. package/dist/utils/logger.js +63 -0
  49. package/dist/utils/price.js +21 -0
  50. package/dist/utils/rpc.js +126 -0
  51. package/dist/utils/signer.js +350 -0
  52. package/docs/adr/0001-neutral-infrastructure.md +50 -0
  53. package/docs/architecture.md +62 -0
  54. package/docs/cache-policy.md +42 -0
  55. package/docs/clients.md +78 -0
  56. package/docs/deployment.md +102 -0
  57. package/docs/development.md +51 -0
  58. package/docs/install-snippets.md +236 -0
  59. package/docs/load-testing.md +51 -0
  60. package/docs/operations.md +56 -0
  61. package/docs/release-provenance.md +63 -0
  62. package/docs/tools.generated.md +89 -0
  63. package/docs/tools.md +102 -0
  64. package/docs/usage.md +157 -0
  65. package/docs/write-operations.md +223 -0
  66. package/package.json +77 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,118 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project are documented here.
4
+ This project follows [Conventional Commits](https://www.conventionalcommits.org) and [Semantic Versioning](https://semver.org).
5
+
6
+ ## [0.4.0](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/compare/v0.3.0...v0.4.0) (2026-07-01)
7
+
8
+
9
+ ### Features
10
+
11
+ * add neutral dry-run default ([71593f1](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/71593f1cda926d3deafd9ee38be2ddd8e80a4a86))
12
+ * add public endpoint readiness ([8e35d21](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/8e35d2180088526501cf04681cbcc0deab6c6ec1))
13
+ * add write capability profiles ([413c7f2](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/413c7f28ee28f6b607ec21c1e2d804fee03cb028))
14
+ * align MCP server with dblurt 0.15 ([968b8fb](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/968b8fb7ba54cf6ff64896b25d1fcc4ab9c5b366))
15
+ * optional testnet support via BLURT_CHAIN_ID / BLURT_ADDRESS_PREFIX ([480ad57](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/480ad57e4065889be344971653059fc5425ca521))
16
+ * prepare official npm package ([5640a09](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/5640a0917e949a0f78d1e9253d4d9cdd8964d646))
17
+
18
+
19
+ ### Documentation
20
+
21
+ * add Onboarding area and operation history to the README capability table ([4ec5a45](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/4ec5a4566604cbef7af0c0251135cbc17e485954))
22
+ * document unsafe HTTP signing override ([0a1fa6d](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/0a1fa6daf5525df9f6dc495569200844179cd680))
23
+ * fix npm bin snippets ([073ed8b](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/073ed8ba3e81b6607c6d3d1cd40daf3ecdf555c2))
24
+
25
+
26
+ ### Continuous Integration
27
+
28
+ * install git for preflight jobs ([24f1ca8](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/24f1ca8d0b8f5a640f679fce287dec476d9859b0))
29
+
30
+ ## [0.3.0](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/compare/v0.2.0...v0.3.0) (2026-06-29)
31
+
32
+
33
+ ### Features
34
+
35
+ * add 11 social read/write tools with denylist gating ([dd86be5](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/dd86be5a39e4cbabe6091ea1640ba5cf6f1f1c21))
36
+ * add blurt-upvote and blurt-comment write tools ([62c5dfd](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/62c5dfd50032840a3fa47695054deaf6469894d7))
37
+ * add opt-in write operations (claim-rewards) with controlled env loading ([3edd5b9](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/3edd5b9e46197cbf5287df90ff45517003554690))
38
+ * annotate tools with readOnlyHint for client permission grouping ([127df9d](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/127df9d7ec1d1a180bbf63577010aa7cc1e7a780))
39
+ * support delegated posting authority for write signing ([4e5a1eb](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/4e5a1eb008bdb2457890ff72f665a54306d65f32))
40
+
41
+
42
+ ### Bug Fixes
43
+
44
+ * silence dotenv output to keep the stdio MCP stream clean ([8170c3e](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/8170c3e1c3a7048185c9838a0b681f1a1c8149de))
45
+
46
+
47
+ ### Documentation
48
+
49
+ * restructure documentation — lean showcase README + docs/ guides ([efc34ba](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/efc34ba83618ea2b47b2f3607ab4892be74b6669))
50
+ * translate remaining French code comments to English ([c7c5c79](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/c7c5c79cb9b0cb4188d16f1175733bd78845dde1))
51
+
52
+
53
+ ### Build System
54
+
55
+ * update @beblurt/dblurt to 0.14.0 ([61cf9fb](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/61cf9fb0f2ec2c12e77086154341f879254117e2))
56
+ * update @beblurt/dblurt to 0.14.1 ([867a9a0](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/867a9a030ec83052db20ba9faba50312a1a42f21))
57
+
58
+ ## [0.2.0](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/compare/v0.1.0...v0.2.0) (2026-06-28)
59
+
60
+
61
+ ### Features
62
+
63
+ * add a local stdio entrypoint ([388286f](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/388286f808f5d9d98ea3003bbc771a5251d46307))
64
+ * add governance, social and account-comparison tools ([942cbd7](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/942cbd7728d7b746b1191d64844ef390e25a96d9))
65
+ * add network, market, community and curation tools ([9026902](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/90269024df30ef5db633cc73524acace52f3d5ca))
66
+ * dynamic RPC node selection via blurt-nodes-checker ([7c942d1](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/7c942d1271a931a434608123aa2b5d55425208fb))
67
+
68
+
69
+ ### Bug Fixes
70
+
71
+ * cap the HTTP request body size (256kb) ([8036bff](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/8036bff5a4b538df5b17b3f8622de96e6c862e7a))
72
+ * use the dblurt core RPC transport to stop RPC calls hanging ([a44c89e](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/a44c89ec6347b3cdeceb56b63db198faa44aa4c6))
73
+
74
+
75
+ ### Performance
76
+
77
+ * truncate post bodies in get-account-posts ([385b405](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/385b405f091755ef43767c4cceb7cd4222df97f3))
78
+
79
+
80
+ ### Documentation
81
+
82
+ * add SECURITY.md (security model + write-phase principles) ([a49cdce](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/a49cdce5c705df2796c19d8a7b3c0e7d6e83f4fe))
83
+ * README audit — ToC, badges, stdio, deploy notes, contributing ([e53d7c1](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/e53d7c128bb79c87143c75bba3ad671331760c19))
84
+ * strengthen existing tool descriptions for LLM tool-selection ([482dd48](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/482dd48c037f14d0c794312624519424095ba286))
85
+
86
+
87
+ ### Build System
88
+
89
+ * make the package public ([5e6c39a](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/5e6c39a2607a24f3c5020f47c294a13427bef953))
90
+ * update dependencies to resolve npm audit advisories ([88398b2](https://gitlab.com/blurt-blockchain/blurt-mcp-server/-/commit/88398b25f02e6ccbf48c8449b98fa428210cbf6d))
91
+
92
+ ## 0.1.0 (2026-06-26)
93
+
94
+ Initial release.
95
+
96
+ ### Features
97
+
98
+ * MCP server over stateless Streamable HTTP (Express 5) exposing the Blurt blockchain via `@beblurt/dblurt`.
99
+ * Tools: `get-account`, `get-account-history`, `get-account-posts`, `get-post`, `get-publications`.
100
+ * `search` / `fetch` tools following the connector convention, plus `blurt://` resource templates (account, history, posts, post).
101
+
102
+ ### Bug Fixes
103
+
104
+ * Resolve the ranked-posts URI sort from the path (`blurt://posts/<sort>/<tag>`) so `fetch` returns the correct posts.
105
+ * Correct `search` routing so `posts:<tag>` keeps the full tag and `posts/<sort>/<tag>` is no longer captured as a single post.
106
+
107
+ ### Performance
108
+
109
+ * Instantiate the Blurt client once and share it across requests (RPC failover state is preserved).
110
+ * Fetch the independent account lookups in `get-account` in parallel.
111
+
112
+ ### Tests
113
+
114
+ * Offline suite (URI parsing + search routing) and live suite (every tool against a real RPC node).
115
+
116
+ ### Build System
117
+
118
+ * GitLab CI pipeline (typecheck, test, build) and `commit-and-tag-version` release tooling.