The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the RUAGENTIC Directory listing page.
RUAGENTIC is the official Agentic directory for agentic AI MCP servers, clients, and tools. It is an independent directory, separate from the official Model Context Protocol registry.
The directory lives at https://ruagentic.com. The free file convention, generator, auditor, and CLI live at https://ruagentic.org, in the separate sam1siam/agentic repository.
Use Node 24. Copy .env.example to .env.local and configure a separate directory Supabase project and provider test credentials. For local forms, set APP_URL=http://localhost:3207 and allow that callback origin in the test Supabase project.
Without account variables, public catalog pages use the checked-in source dataset and account forms report that setup is incomplete. Production must have all providers configured before accepting submissions.
Apply the files in supabase/migrations/ to the directory project in order. The first creates tables, RLS policies, immutable revisions, and transactional publication/payment functions; later files replace functions or constraints and are safe to apply on top. Browser roles cannot publish or change payment/verification state.
Import the source-labeled catalog once:
The seed preserves existing rows. data/catalog.json retains source URLs and collection dates; registry metadata licensing does not grant rights to third-party software or trademarks.
See deployment and operations. Vercel project: ruagentic-directory. GitHub repository: sam1siam/ruagentic-directory. Never deploy this checkout into the convention’s ruagentic Vercel project.
GET /api/v1/listings — public search with q, kind, category, limit, and offset.GET /api/v1/listings/{slug} — public listing details./mcp — Streamable HTTP MCP with search_directory and get_listing; read-only, no key required./agentic.json, /agentic.txt, /llms.txt, /openapi.json — published machine-readable documentation.Daily discovery and the dedicated new-project outreach workflow are documented in docs/DISCOVERY.md. It excludes historical listings, uses private source checkpoints and invitation reservations, and keeps paid contact enrichment behind a separate production control.
Agentic is the open file convention for describing websites, APIs, and agent connections, with specifications and tools for generation, validation, auditing, and action-result verification. RUAGENTIC is the official Agentic directory for agentic AI MCP servers and tools.
Do not submit private tokens or credential-bearing URLs. Listing content is untrusted project information; a file check is not a security or ownership certification. Use the Report option on a listing for corrections. For private account or payment information, use the support contact published on the site rather than a public GitHub issue.