docs: remote MCP tool parity and API changes from lettr#489 - #71
Open
voj-tech-j wants to merge 2 commits into
Open
voj-tech-j wants to merge 2 commits into
voj-tech-j wants to merge 2 commits into
Conversation
Email history pagination takes next_cursor back unchanged, pulls an old `from` forward to the retention limit and requires `to` after `from`. Unschedule also clears a delivery time staged on a draft. Lists that segments are scoped to cannot be deleted (409 list_in_use), segments reject unsupported conditions, a contact's list_id must exist, and webhook names are capped at 24 characters with updates needing a field. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The remote MCP server now registers 77 tools, reaching parity with the lettr-mcp package, but the pages still marked domain management, template delete, merge tags and webhook details as local only and listed no campaign, audience, scheduling or email history tools. The availability table now has a row per tool on either server (77 remote, 69 local), every tool has a reference section, stale parameter tables are corrected (idempotency_key, optional subject and folder_id, template purpose, slug and domain identifiers), and the local setup page lists the package's 69 tools instead of 14. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs for TOPOL-io/lettr#489 (TPL-2520).
Merge after lettr#489 is deployed — until then these pages describe behaviour production doesn't have yet. The API reference itself needs no change here:
openapi.jsonis fetched from the app on build.MCP pages
The remote server (
app.lettr.com/mcp) now has 77 tools, at parity with thelettr-mcppackage (69). The pages still showed the old split.learn/mcp/tools-reference.mdx— availability table with a row per tool on either server; a reference section for every tool; correctedAvailable onlabels (domain CRUD,delete_template,get_merge_tags,get_webhookare on both); corrected parameters (idempotency_key, optionalsubjectonsend_template_email, optionalfolder_idandpurposeoncreate_template,purpose/folder_idfilters onlist_templates).learn/mcp/introduction.mdx— comparison and capability table no longer present domain or template management as local-only; adds scheduling, email history, webhooks, campaigns, audience.learn/mcp/setup.mdx— "Available Actions" covers all remote tools.learn/mcp/local-setup.mdx— 69 tools instead of 14.learn/domains/sending-domains.mdx— names the domain tools on both servers.API behaviour
learn/sending/email-history.mdxnext_cursoris passed back unchanged (any other cursor → 422);fromolder than ~10 days is pulled forward;tois exclusive and must be afterfromapi-reference/campaigns/unschedule-a-campaign.mdxlearn/audience/lists.mdx,segments.mdx, delete / bulk delete list summarieslist_in_use); bulk deletes nothinglearn/audience/segments.mdxlearn/audience/double-opt-in.mdx, create contact summarylist_id→ 422, no contact createdlearn/webhooks/introduction.mdx,authorization.mdx, webhook quickstartsauth_type, changeable over the APIapi-reference/introduction.mdxresource_already_existsandlist_in_useerror codesmintlify broken-links: no broken links.🤖 Generated with Claude Code