Skip to content

docs(examples): add optional deed.page MCP publishing example - #1068

Closed
f-o-x11 wants to merge 2 commits into
dynamiq-ai:mainfrom
f-o-x11:add-deed-page
Closed

f-o-x11 wants to merge 2 commits into
dynamiq-ai:mainfrom
f-o-x11:add-deed-page

Conversation

@f-o-x11

@f-o-x11 f-o-x11 commented Oct 26, 2026

Copy link
Copy Markdown

Adds a separate opt-in example that publishes an HTML page to a public https://{slug}.deed.page/ URL through Dynamiq's existing MCPServer and MCPStreamableHTTP adapter, then deletes it again. Run python -m examples.components.tools.mcp_server_as_tool.use_deed_page from the repository environment. It publishes a small sample page that expires after an hour. Pass --file report.html, --slug or --ttl 0 to publish your own page or keep it.

The example limits the server to publish_site and delete_site with include_tools. It uses no LLM, API key or account and sends no Authorization header. The first publish returns an owner token. --delete <slug> reads it from DEEDPAGE_TOKEN and exits with a clear message if it isn't set. The adjacent README has the install command, the run and delete commands, and a note that published pages are public. Existing examples and provider defaults are unchanged.

Validated the documented Python 3.12 install and each documented command against the live endpoint. The sample page loaded. Delete without the token failed with the expected message, and with the token it removed the page, which then returned 404. Upstream pre-commit hooks pass on the changed files, plus ruff check and black --check -l 120. I didn't run the full test suite, since only an example and its README change.

The branch has two commits. The second only renames the token variable to DEEDPAGE_TOKEN, so it squashes cleanly.

I'm on the deed.page team (Avatar 8 LLC), which runs this MCP server. Docs: https://deed.page/docs. Agent skill (MIT): https://github.com/f-o-x11/deed-page-skill

@f-o-x11
f-o-x11 requested a review from a team as a code owner October 26, 2026 17:08
@tyaroshko

Copy link
Copy Markdown
Collaborator

Thanks for putting this together. We keep the examples focused on dynamiq features rather than specific third-party services, and connecting to an MCP server is already covered by the existing mcp_server_as_tool examples. A standalone example in your own repo or docs would be the better home for this, so we'll close this one. Thanks for the contribution.

@tyaroshko tyaroshko closed this Nov 2, 2026
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.

2 participants