Agent Access

Agent Access

Let your agent or business platform read REALJOIN services, public pricing, and delivery details, prepare quote, order-intent, and checkout previews, and route confirmation to Telegram. Markdown, JSON APIs, OpenAPI, Skill, CLI, and local MCP resources are available.

Service API

Services and pricing

Read available services, public prices, delivery windows, and required fields.

/api/agent/services

Quote API

Quotes and negotiation

Use a user API key to prepare quotes, budget notes, and Telegram handoff text.

/api/agent/quote

Intent API

Order intents

Create trackable order intents for channel platforms or user-owned agents.

/api/agent/order-intents

Checkout API

Payable checkout

Create a payable order with a user API key and return a payment URL.

/api/agent/checkout

OpenAPI

API schema

Connect GPT Actions, automation workflows, and external agent tools.

/api/agent/openapi.json

CLI

Command line tool

Download a zero-dependency Node CLI for local or server-side REALJOIN calls.

/realjoin-agent.mjs

MCP

Local MCP server

Connect agents over stdio with preview-first write protection.

/agent/mcp.md

CLI Quick Start

Use the CLI in your agent workflow

The CLI works in terminals, server scripts, and agent toolchains. Catalog reads are public; quote, intent, checkout, and Telegram actions preview by default and require a user API key only when explicitly confirmed.

Step 1

Install CLI

npm install -g https://www.realjoin.io/realjoin-agent-kit-1.0.0.tgz

Step 2

Read the catalog

node realjoin-agent.mjs services

Step 3

Set API key

export REALJOIN_API_KEY="<your_api_key>"

Step 4

Preview checkout

realjoin-agent checkout x-follow --target https://x.com/example --contact @telegram

Skill

Readable instructions for agents

The Skill tells external agents how to read the catalog, choose services, prepare quotes, create order intents, create payable checkout links, and route human confirmation to Telegram.

npx -y skills add https://www.realjoin.io/agent/skill.md -g -y

Machine-readable catalog

Complete service and package data is available to agents

Complete data is available through Markdown, JSON, and OpenAPI. External agents can read every service, package price, delivery window, required field, and use case.

Telegram contact

Services

33

Every listed service is discoverable by agents.

Packages

108

Every package, price, and delivery detail is returned in service details.

Markdown

/agent/services.md

Readable by agents for direct planning and summarization.

OpenAPI

/api/agent/openapi.json

Built for GPT Actions, automation tools, and external platforms.

Reviewable integration flow

Discover → quote → intent → review → pay → verify status

Public reads

Catalog, prices, required fields, and OpenAPI can be read without a user key so agents can match services first.

Controlled writes

Quotes, order intents, and checkout use a user API key. Grant only required access and never place secrets in prompts, clients, or public logs.

Human review

Confirmation-required or platform-sensitive tasks must be reviewed by a person; a payable link never overrides the Acceptable Use Policy.