Skip to content

Add read-only Substack MCP integration - #16

Merged
cucoleadan merged 5 commits into
mainfrom
feature/mcp-readonly
Aug 3, 2026
Merged

Add read-only Substack MCP integration#16
cucoleadan merged 5 commits into
mainfrom
feature/mcp-readonly

Conversation

@cucoleadan

@cucoleadan cucoleadan commented Aug 3, 2026

Copy link
Copy Markdown
Owner

Summary

  • add a read-only STDIO MCP server with five Substack tools
  • add environment validation, bounded results, structured JSON, and friendly authentication errors
  • add the substack-mcp package binary, mocked MCP tests, and Codex configuration documentation
  • bump the package and MCP server version to 0.3.0

Safety

  • all MCP tools are read-only
  • .codex/config.toml is ignored and has never been committed
  • .dev.vars is not tracked; only .dev.vars.example is present
  • published commit history was scanned for common credential patterns with no matches
  • GitHub secret scanning reports zero open alerts

Verification

  • bun run test:all — 37 tests passed
  • MCP protocol initialization and five-tool discovery passed
  • live read-only get_notes(limit: 1) smoke test passed
  • bun run pack produced the 0.3.0 npm-compatible package successfully

- Introduced `mcp-server.ts` to handle MCP server logic and tool registration.
- Created `mcp.ts` for command-line interface to connect the MCP server.
- Updated `package.json` to include new binaries and dependencies.
- Enhanced build script to compile multiple source files.
- Added type definitions for Node.js in `tsconfig.build.json`.
- Implemented tests for MCP tools in `mcp.test.ts` to ensure functionality and error handling.
@cucoleadan cucoleadan changed the title Add read-only Substack MCP integration and Note replies API Add read-only Substack MCP integration Aug 3, 2026
@cucoleadan
cucoleadan marked this pull request as ready for review August 3, 2026 08:16
@github-actions
github-actions Bot enabled auto-merge (squash) August 3, 2026 08:16
@cucoleadan
cucoleadan merged commit f92170e into main Aug 3, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant