Skip to main content
Glama
Sign In
studyofus-agent

studyofus-agent

by aminamos
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

studyofus-agent

Unofficial REST + CLI + MCP for a proposed Study of Us agent API.

Not affiliated with Aella, studyofus.com, or aella.lol. This repo does not call those sites. It runs a local mock. Point STUDYOFUS_API_BASE at an official API only after the operator gives you one.

Why

Study of Us is a public beta face-perception study (see PRODUCT.md). Agent traffic should not refresh the HTML app. This kit is the agent side: ids, votes, reports — no image scraping.

Related MCP server: Cubi MCP Playground

Run the mock API

cd E:\development\studyofus-agent
bun install
bun run api

Listens on http://127.0.0.1:3320.

CLI

bun run cli health
bun run cli catalog
bun run cli me
bun run cli report
bun run cli vote --game rate-men --left L1 --right R1 --pick left

MCP

Stdio server: bun run mcp. Configure your agent to run that command with:

STUDYOFUS_API_BASE=http://127.0.0.1:3320
STUDYOFUS_TOKEN=dev-token

Tools: sou_health, sou_catalog, sou_me, sou_report, sou_vote.

Env

See .env.example. The client refuses studyofus.com and aella.lol hostnames.

License

MIT.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mock-mcp

      it370
      F
      license
      Not graded
      quality
      C
      maintenance
      A minimal local HTTP MCP mock server for development and testing, providing predictable tool responses with OAuth token support and zero dependencies.
      -

    • Cubi MCP Playground

      jhonigberg-cubi
      F
      license
      Not graded
      quality
      D
      maintenance
      Enables local prototyping of Cubi integrations with a mock HTTP server, MCP tools for lifecycle management, and a browser UI for workflow testing without real sandbox credentials.
      1
      -

    • Discovery Agent MCP Server

      puneethvenkatm
      F
      license
      Not graded
      quality
      D
      maintenance
      Enables MCP-compliant agents to perform data discovery, schema matching, and export via HTTP, with a mock mode for demonstration.
      -

    • instant-mcp

      jhleee
      A
      license
      Not graded
      quality
      D
      maintenance
      A local mock MCP server for building against the Model Context Protocol. Write a tool in the browser, save it, and it is immediately available on an MCP endpoint.
      MIT