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.
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 three tools: search_listings (search or browse active listings with category, price, and keyword filters), get_listing (one listing by id, including its full description), and get_market_stats (verified marketplace statistics: audience size, listing volumes, and response rates). 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.
Set up the SUpost MCP server in your AI assistant
The server is free, read-only, and needs no account or API key. Its endpoint is:
https://mcp.supost.com/mcpClaude (claude.ai and desktop app)
Go to Settings → Connectors → Add custom connector, name it “SUpost”, and paste the endpoint URL above. 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/mcpCursor
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.
Try it
Once connected, ask your assistant things like:
- “Find me a furnished sublet near Stanford under $1,800 on SUpost.”
- “What bikes are for sale on SUpost right now?”
- “How likely is a housing listing on SUpost to get a response?”