Skip to main content
Glama
aminamos

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.

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

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mock-mcp

    it370
    F
    license
    Not graded
    quality
    B
    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
    C
    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
    C
    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