langchain-simplepages

LangChain tools for Simplepages, an AI landing page and website builder. Your agent can build a page, edit it, and read how it performed.

The package is a thin adapter over the hosted Simplepages MCP server. It discovers whatever tools the server advertises and hands them back as ordinary LangChain BaseTool objects, with names, descriptions and JSON schemas passed through untouched.

Install

pip install langchain-simplepages

Get a token

Sign in to Simplepages, open Settings > MCP access, and generate a token. Then:

export SIMPLEPAGES_TOKEN="..."

Full details at simplepages.ai/mcp.

Use it

import asyncio
from langchain.agents import create_agent
from langchain_simplepages import SimplepagesToolkit


async def main():
    tools = await SimplepagesToolkit().get_tools()
    agent = create_agent("claude-sonnet-4-5-20250929", tools=tools)
    result = await agent.ainvoke(
        {
            "messages": [
                {
                    "role": "user",
                    "content": "Build a landing page for a Leeds accounting firm that files "
                    "year-end tax returns for freelancers. CTA: book a 20-minute call.",
                }
            ]
        }
    )
    print(result["messages"][-1].content)


asyncio.run(main())

SimplepagesToolkit() reads SIMPLEPAGES_TOKEN from the environment. Pass api_key="..." to override it.

Tools

Nothing publishes on its own. create_page and edit_page write to a draft. A page goes live only when someone publishes it from the Simplepages dashboard, so an agent that gets carried away cannot put anything in front of your visitors.

Restricting the tool set

tool_filter takes a collection of names or a predicate. To give an agent read access and nothing more:

toolkit = SimplepagesToolkit(
    tool_filter=[
        "list_pages",
        "list_sites",
        "get_page",
        "get_page_analytics",
        "get_workspace_analytics",
    ],
)

Configuration

Sync code

get_tools() is async, because the MCP client underneath is. From synchronous code, use get_tools_sync():

tools = SimplepagesToolkit().get_tools_sync()

It raises if called from inside a running event loop, where blocking on the async client would deadlock. Await get_tools() there instead.

Errors

A missing or rejected token raises SimplepagesAuthError (a ValueError) naming the environment variable and where to generate a replacement. Everything else, including network failures and server errors, propagates unchanged.

Requirements

Python 3.10 or newer, which is the floor set by langchain-mcp-adapters.

Development

uv sync --all-groups
uv run pytest tests/unit_tests    # no network, no credentials
uv run ruff check .
uv run mypy langchain_simplepages

Integration tests hit the real server and are skipped unless a token is present:

SIMPLEPAGES_TOKEN=... uv run pytest tests/integration_tests

Links

• Simplepages MCP docs
• MCP server manifests
• Registry name: ai.simplepages/simplepages

License

MIT