How can AI agents access SUpost?
SUpost (supost.com) offers first-class access for AI agents: a remote MCP (Model Context Protocol) server at https://mcp.supost.com/mcp, a public read-only JSON API, markdown renditions of key pages, and a curated site map at supost.com/llms.txt. No API key or account is required.
Quick start — add SUpost to your AI assistant
The server is free, read-only by default, and needs no account or API key.
Claude Code — one command:
claude mcp add --transport http supost https://mcp.supost.com/mcpClaude (claude.ai / desktop) & other MCP clients — the endpoint:
https://mcp.supost.com/mcpIn Claude: Settings → Connectors → Add custom connector → name it “SUpost” and paste the URL. Full per-client instructions are below.
What you can do with it — finding housing, three stories
Once connected, your assistant gets six SUpost tools: search_listings, get_listing, list_categories, get_market_stats, send_message, and create_post. Housing is where they shine — good rooms near campus go fast, and an assistant that can search, compare, and reach out for you is how you stop losing the race. Three stories:
Maya finds a fall room without ever opening a browser tab
Incoming CS master's student, still in Ohio. Needs a furnished room within biking distance of campus before autumn quarter, budget $1,800.
You: “I'm starting at Stanford in late September. Find me a furnished room or studio I can bike to campus from, under $1,800 a month.”
Her assistant asks SUpost for the housing taxonomy (list_categories — rooms/shared, sublets/temporary, apts/housing…), then runs search_listings over the right subcategories with her price cap and summarizes a shortlist with links: a room in a shared College Terrace house, an Escondido Village-adjacent studio, a Menlo Park in-law unit near the Caltrain station.
You: “The College Terrace one and the studio look promising — pull up the full posts.”
get_listing fetches each post’s full description, price, photos, and posting date, so the assistant can compare them side by side: the College Terrace room is $1,650 with utilities unclear; the studio is $1,795 but a 25-minute ride.
You: “Is $1,650 for a room in College Terrace actually a fair deal?”
get_market_stats returns verified marketplace statistics — listing volume, response rates, and going rates — so she knows $1,650 walkable to campus is worth moving on today, not after her Ohio lease wraps up.
You: “Ask the College Terrace poster if it's still available, whether utilities are included, and if a September 20 move-in works.”
send_message submits the note with Maya’s own reply-to email. Nothing is delivered until she clicks a confirmation link SUpost emails her — an agent can never send mail as you without your sign-off.
Diego sublets his apartment before a spring internship in New York
Second-year PhD student heading east for spring quarter. Between paper deadlines, he'd rather not fight a posting form.
You: “Post my furnished EVGR studio on SUpost for spring quarter — $1,400 a month, April through mid-June, five-minute bike to the Oval. Use my stanford.edu email.”
create_post creates a draft listing — title, housing category, price, description — and hands back a private continue link where Diego adds photos, reviews, and publishes. Stanford and alumni emails post free.
You: “Skip the photos, just publish it — I want it live before my 9am flight.”
The assistant re-calls create_post with instant publish: SUpost emails Diego a one-click publish link, and the post goes live the moment he taps it. Drafts never go live without the poster — the email click is the one step an agent can’t do.
Priya puts her assistant on sublet watch
Coterm hunting mid-year, when the good sublets are gone by lunch. Instead of refreshing the feed between lectures, she schedules a routine (Claude routines, ChatGPT tasks, or a Claude Code cron job).
You: “Every morning at 8, search SUpost for new sublets and shared rooms under $2,000, compare against what you found yesterday, and send me only the new ones with details.”
The routine runs search_listings on schedule, diffs the results against the previous day, and pulls get_listing details for anything new — so the 9:02am sublet posting is in her inbox while everyone else is still in section. Reading is unauthenticated and rate-limit friendly, so a daily or even hourly watcher is well within budget.
You: “Also flag anything that mentions 'furnished' and a spring move-in.”
Routines are just prompts — she can tune the filters in plain English. One caution: keep the write tools (posting, messaging) out of unattended routines. Both require her email confirmation anyway, so they only make sense interactively.
The same recipes work beyond housing — watch the Bicycles category for anything under $150, get a weekly digest of research-assistant job posts, or price your own couch against get_market_stats before you list it.
Setup, client by client
Claude (claude.ai and desktop app)
Go to Settings → Connectors → Add custom connector, name it “SUpost”, and paste https://mcp.supost.com/mcp. Available on all paid plans; on team plans an admin may need to enable custom connectors.
Claude Code
claude mcp add --transport http supost https://mcp.supost.com/mcpRestart Claude Code (or start a new session) and the tools appear as mcp__supost__*.
Cursor
Or add it manually to ~/.cursor/mcp.json:
{
"mcpServers": {
"supost": { "url": "https://mcp.supost.com/mcp" }
}
}VS Code (GitHub Copilot)
Or run MCP: Add Server from the command palette, choose HTTP, and paste the endpoint URL.
ChatGPT
Custom MCP connectors require a paid plan: Settings → Connectors → Advanced → Developer mode, then add the endpoint URL as a new connector.
How can AI agents access SUpost?
AI agents can access SUpost (supost.com), the Stanford student marketplace, through its remote MCP server at https://mcp.supost.com/mcp (streamable HTTP transport, no authentication) or through the public read-only JSON API at supost.com/api/public/listings. Both expose active listings — id, title, price, category, posting date, and canonical URL — with no personal information.
What tools does the SUpost MCP server provide?
The SUpost MCP server provides six tools. Reading: search_listings (search or browse active listings with category, price, and keyword filters), get_listing (one listing by id, including its full description), get_market_stats (verified marketplace statistics), and list_categories (the category/subcategory taxonomy). Acting: send_message (message a poster — delivery happens only after the sender clicks an emailed confirmation link) and create_post (creates a draft listing and returns a link where the poster adds photos, reviews, and publishes). Add it to an MCP client as a streamable-HTTP server at https://mcp.supost.com/mcp.
Is there a plain HTTP API for SUpost listings?
Yes — SUpost serves a public read-only listings API at supost.com/api/public/listings, returning JSON with cursor pagination (up to 50 listings per page). The OpenAPI spec lives at supost.com/api/public/openapi.json, and responses are CDN-cached for five minutes.
What are the terms for automated access to SUpost?
Personal use and AI-agent use of SUpost data — searching, summarizing, recommending, and citing listings with a link back — are welcome and free. Bulk redistribution, mirroring the marketplace, or reselling the data is not permitted. Requests are rate-limited to roughly 60 per minute per IP.