ONGSOOLABS
한국어

READER MCP GUIDE

Give Codex, Cursor, and Antigravity
one Reader tool.

Connect the OngsooLabs MCP server to Codex, Cursor, and Google Antigravity with an existing Workspace API key. The first scope contains one URL-reading tool.

Reader MCP Available in Production

AUTHENTICATION

Use your existing Workspace API key.

Codex reads the key from its bearer-token environment variable. Keep the key out of browser code, URLs, repositories, and support messages.

CREDIT USAGE

1 credit only after a successful Reader result.

Authentication, input, safety, limiter, and receipt-rejection failures use 0 credits.

FIRST SCOPE

Three verified clients and one tool.

Claude Code is under verification because of access restrictions. Claude Desktop and claude.ai connectors, OAuth browser login, and additional tools are not included.

CODEX CONFIGURATION

Register the MCP server.

https://ongsoolabs.com/mcp

Store the API key in the named environment variable, then add this server entry to your Codex configuration.

[mcp_servers.ongsoolabs]
url = "https://ongsoolabs.com/mcp"
bearer_token_env_var = "ONGSOOLABS_API_KEY"
TOOL

reader_read_url

public HTTP/HTTPS URL → Reader result

Read one public HTTP or HTTPS URL and return the canonical Reader result to the agent.

ParameterRequirementDescription
urlRequiredOne absolute public HTTP or HTTPS URL, up to 2,048 characters.
idempotency_keyRequiredA UUID-D or uppercase ULID for one logical call. Reuse it only for an exact retry.

RETRY AND RECEIPT

Retry one logical call safely.

Replay: The same key and URL replay the completed result for up to 900 seconds without another credit. After that, use a new key.

Failure: Expired receipts return IDEMPOTENCY_RESULT_EXPIRED at 0 credits; unsafe URLs and rejected input also use 0 credits.