범위가 지정된 관리 토큰을 통해 블록체인 RPC 키, 네트워크, 사용량 및 선불 결제를 관리합니다.
다른 이름 SolidRPC/agent-toolkit, agent-toolkit, @solidrpc/agent
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.1.1
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
SolidRPC MCP란?
SolidRPC은(는) MCP server입니다. 범위가 지정된 관리 토큰을 통해 블록체인 RPC 키, 네트워크, 사용량 및 선불 결제를 관리합니다.
프로젝트 README에서 생성된 요약
SolidRPC MCP server 정보
SolidRPC는 블록체인 RPC 연결을 위한 관리 계층을 제공하여, 개발자가 정의된 예산 내에서 다양한 네트워크에 애플리케이션을 연결할 수 있도록 지원합니다. 라우팅, 모니터링, 장애 조치와 같은 복잡한 작업을 단일 통합을 통해 처리합니다. 툴킷에는 Node.js 관리 클라이언트와 solidrpc mcp 명령어로 실행 가능한 로컬 MCP server가 포함되어 있습니다. Claude Desktop, Cursor, Codex와 같은 AI 클라이언트와 함께 사용하도록 설계되었습니다.
사용자는 계정, 키, 사용량 및 결제를 제어하는 sa_ 관리 토큰을 사용하여 인프라를 관리합니다. 실제 블록체인 요청에는 ak_ RPC 키를 사용합니다. 서버는 네트워크 검색, RPC 키 생명주기 관리, 사용량 추적 및 결제 문의를 위한 도구를 제공합니다. 개발자는 SOLIDRPC_READ_ONLY 환경 변수를 설정하여 읽기 전용 세션을 강제할 수 있으며, 이 경우 전체 도구 목록은 표시되지만 데이터 변경 및 자격 증명 작업은 방지됩니다.
활용 사례
- 1블록체인 네트워크 사용량 모니터링AI 에이전트가 현재 RPC 사용량과 결제 상태를 확인하여 비용이 승인된 예산 내에서 유지되도록 관리할 수 있습니다.
- 2RPC 자격 증명 관리개발자가 에이전트에게 특정 블록체인 네트워크를 위한 RPC 키 목록을 조회하거나 새로 생성하도록 지시할 수 있습니다.
- 3사용 가능한 블록체인 네트워크 검색에이전트가 연결 가능한 지원 네트워크가 무엇인지 식별할 수 있습니다.
- 4읽기 전용 액세스 강제개발자가 AI 클라이언트의 권한을 제한하여 계정 설정이나 키를 수정하지 못하게 하면서 데이터 조회만 가능하도록 설정할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
SolidRPC MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 SolidRPC MCP 설치
$ claude mcp add --env 'SOLIDRPC_TOKEN_FILE=<SOLIDRPC_TOKEN_FILE>' agent-toolkit -- npx -y @solidrpc/agentCursor에 SolidRPC MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"agent-toolkit": {
"command": "npx",
"args": [
"-y",
"@solidrpc/agent"
],
"env": {
"SOLIDRPC_TOKEN_FILE": "<SOLIDRPC_TOKEN_FILE>"
}
}
}
}VS Code에 SolidRPC MCP 설치
.vscode/mcp.json
{
"servers": {
"agent-toolkit": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@solidrpc/agent"
],
"env": {
"SOLIDRPC_TOKEN_FILE": "<SOLIDRPC_TOKEN_FILE>"
}
}
}
}VS Code CLI에 SolidRPC MCP 설치
$ code --add-mcp '{"name":"agent-toolkit","type":"stdio","command":"npx","args":["-y","@solidrpc/agent"],"env":{"SOLIDRPC_TOKEN_FILE":"<SOLIDRPC_TOKEN_FILE>"}}'Claude Desktop에 SolidRPC MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"agent-toolkit": {
"command": "npx",
"args": [
"-y",
"@solidrpc/agent"
],
"env": {
"SOLIDRPC_TOKEN_FILE": "<SOLIDRPC_TOKEN_FILE>"
}
}
}
}Codex에 SolidRPC MCP 설치
$ codex mcp add agent-toolkit --env 'SOLIDRPC_TOKEN_FILE=<SOLIDRPC_TOKEN_FILE>' -- npx -y @solidrpc/agentCodex config.toml에 SolidRPC MCP 설치
~/.codex/config.toml
[mcp_servers.agent-toolkit] command = "npx" args = ["-y", "@solidrpc/agent"] [mcp_servers.agent-toolkit.env] SOLIDRPC_TOKEN_FILE = "<SOLIDRPC_TOKEN_FILE>"
Gemini CLI에 SolidRPC MCP 설치
$ gemini mcp add -s user -e 'SOLIDRPC_TOKEN_FILE=<SOLIDRPC_TOKEN_FILE>' agent-toolkit npx -- -y @solidrpc/agentGemini settings.json에 SolidRPC MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"agent-toolkit": {
"command": "npx",
"args": [
"-y",
"@solidrpc/agent"
],
"env": {
"SOLIDRPC_TOKEN_FILE": "<SOLIDRPC_TOKEN_FILE>"
}
}
}
}구성
SOLIDRPC_TOKEN_FILE필수Absolute path to a private file containing only your sa_ management token. Requires Node.js 22.20.0 or newer.
| 이름 | 설명 | 유형 |
|---|---|---|
| SOLIDRPC_TOKEN_FILE | Absolute path to a private file containing only your sa_ management token. Requires Node.js 22.20.0 or newer. | 필수 |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능solidrpc/agent-toolkit is public and reachablegithub.com/solidrpc/agent-toolkit ↗통과
- 패키지가 이 저장소를 소스로 명시@solidrpc/agent names solidrpc/agent-toolkit as sourcenpmjs.com/package/@solidrpc/agent ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-11github.com/solidrpc/agent-toolkit ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @solidrpc/agent통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음the package checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기SolidRPC agent toolkit
Let an agent connect your application to blockchain RPC within your approved budget. SolidRPC handles routing, failover, monitoring, and recovery behind one RPC integration.
This repository contains a Node.js management client, a local MCP server, an agent skill, and runnable RPC examples. The hosted MCP endpoint is also available at https://api.solidrpc.io/agent/mcp.
Start here
Read agent onboarding and the setup guide. The live onboarding response supplies availability, payment network, terms, pricing, limits, and recovery steps. Read those values at setup time.
For an existing account, delegate an agent credential from a paid plan or PAYG account. Free accounts cannot delegate agent control. For a new account, obtain the owner's email, account-creation and terms approval, and separate payment and usage ceilings. Account provisioning itself spends nothing. Email verification and a password are not required for agent activation. The owner can claim dashboard access later.
| Credential | Purpose | Destination |
|---|---|---|
sa_ management token |
Account, keys, usage and billing | https://api.solidrpc.io/agent/v1 and /agent/mcp |
ak_ RPC key |
Blockchain requests | RPC URL returned by /networks |
Install
Requires Node.js 22.20 or later. In a downloaded checkout of this toolkit:
npm ci --ignore-scripts
npm test
node src/cli.mjs request GET /onboarding
Install the pinned version from npm:
npm install --global @solidrpc/agent@0.1.1
solidrpc --help
solidrpc request GET /onboarding
The CLI and local MCP server are included in this one package. Run solidrpc mcp to start the MCP server. Release downloads contain the npm tarball, source ZIP, and desktop MCP bundle. The bundle includes its runtime dependencies and requires Node.js 22.20 or later.
For development, use the source commands above or install a locally built tarball. Published downloads are available in GitHub Releases. See the release procedure for review and verification.
Give your agent access
Save only the sa_ token in an owner-only file outside your repository. Configure SOLIDRPC_TOKEN_FILE with its absolute path. A secret manager can supply SOLIDRPC_TOKEN instead. Choose one source.
export SOLIDRPC_TOKEN_FILE=/absolute/private/solidrpc-management.key
solidrpc request GET /me
solidrpc request GET /networks
solidrpc mcp
From a source checkout, replace solidrpc with node src/cli.mjs.
MCP setup templates for Codex, Claude Code/Desktop, and Cursor are in configs. They use the local process and a token file. The server reads that one file and sends the token to the SolidRPC management API by default. An explicit SOLIDRPC_URL override can send it to a loopback development server. Never use a real credential for loopback tests. Redirects are rejected.
Set SOLIDRPC_READ_ONLY=1 for a locally enforced read-only session. The server still advertises its full tool catalog, but blocks every mutation, credential operation and RPC-key secret read before a network call. Server-side credential scopes remain the authority for account permissions.
Account provisioning and recovery
Read the terms URLs and current revision in onboarding. After owner approval, send JSON on stdin:
node src/cli.mjs provision < /absolute/private/approved-account.json
The input contains email, termsRevision, and acceptTerms: true. The CLI saves the bootstrap secret before the network request. Repeat the same input and profile after a lost response. Use SOLIDRPC_PROFILE for separate accounts.
Follow the live onboarding steps to sign the approved budget and fund the account. The published payment example explains the external wallet flow. This toolkit does not hold wallet keys or automatically pay. Persist idempotency keys and payment proofs privately before submission. For uncertain payments, inspect the existing funding intent and follow its recovery instructions. Never create a second payment to guess whether the first succeeded.
After funding settles, rotate the bootstrap credential to obtain operational scopes. solidrpc rotate saves a replacement and a private retirement journal before retiring the old credential. Its output includes scopes and bootstrap status. If retirement fails, it returns replacementSaved:true and oldRevoked:false with exit code 2. Run solidrpc retire-previous to retry retirement without creating another credential. For external token files or secret managers, use explicit management requests and persist the replacement before revoking the old token. If rotation's response is lost, the old token remains usable. Repeated rotation can create orphaned credentials, so inspect and retire those deliberately.
solidrpc request emits the API response. Key creation and credential rotation can return secrets. On POSIX shells, use an owner-only directory and create a fresh output file with private permissions. For example, with approved key creation input:
(umask 077; set -C; solidrpc request POST /keys \
< /absolute/private/approved-key-request.json \
> /absolute/private/created-key.json)
Use a new output filename for each attempt and reuse the same idempotency key when retrying the same request. On Windows, use an owner-only directory and file ACLs. sa_ credentials alone cannot approve a wallet budget. Card subscription purchases remain an owner action.
Tools
The MCP server exposes network discovery, RPC key listing/creation/revocation, usage, billing, top-up quotes, support tickets, and a generic management request tool. A top-up quote does not transfer USDC. Support-ticket creation sends a message, so use it only when the owner requests contact. Clients must retain their own approval controls for writes and payments.
Examples
Use a separate ak_ key in a private file selected by RPC_KEY_FILE, and set RPC_ORIGIN=https://rpc.solidrpc.io. These scripts make billable read calls and require an approved usage budget. Read examples/README.md before running them.
- Base ETH and USDC balances
- Ethereum USDC Transfer export
- Ethereum, Base and Arbitrum connectivity
Agent skill
The skill is in skills/solidrpc/SKILL.md. From a separate project, install this local checkout with the skills CLI:
npx skills add /absolute/path/to/agent-toolkit --skill solidrpc -a codex claude-code cursor
For Cursor, if the shared skill is not listed, copy the same SKILL.md into .cursor/skills/solidrpc/SKILL.md in your project and start a fresh session. Codex uses .agents/skills/solidrpc/SKILL.md, and Claude Code uses .claude/skills/solidrpc/SKILL.md.
Install the skill directly from this public repository:
npx skills add SolidRPC/agent-toolkit --skill solidrpc -a codex claude-code cursor
The same skill is included in the npm package and release downloads. Installing a skill makes it available in that client. It does not make every agent discover or prefer SolidRPC.
Development
Run npm test and npm run check:public. Never add credentials, local profiles, wallet keys, private infrastructure configuration, or unpublished operational records to this repository. The public package is an extraction of the existing SolidRPC client, with local safety and packaging adaptations.
Credential operations are deliberately unavailable through the generic MCP tool. Use the CLI or an explicit API workflow that saves replacement credentials before retiring old ones. Read-only mode also blocks secret retrieval. Creating an RPC key in normal MCP mode still returns the new key through the tool result, so that client's transcript can contain it. Use a CLI request redirected to a private file when the key must stay out of model transcripts.
Configuration storage must be a dedicated private directory. The CLI rejects shared directories instead of changing their permissions. On POSIX systems it also rejects token files accessible to other users or owned by someone else. On Windows, configure owner-only ACLs yourself. Help and version commands do not load credentials.
SolidRPC MCP 질문
SolidRPC MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'SOLIDRPC_TOKEN_FILE=<SOLIDRPC_TOKEN_FILE>' agent-toolkit -- npx -y @solidrpc/agent를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
SolidRPC MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
SolidRPC MCP server를 로컬에서 어떻게 실행하나요?
npm을 통해 패키지를 설치한 후 solidrpc mcp 명령어를 실행하면 로컬 MCP server를 시작할 수 있습니다.
MCP server를 읽기 전용 모드로 사용할 수 있나요?
네, SOLIDRPC_READ_ONLY=1 환경 변수를 설정하면 데이터 변경 및 자격 증명 작업을 차단하는 로컬 읽기 전용 세션을 강제할 수 있습니다.
MCP server에서 제공하는 도구는 무엇인가요?
네트워크 검색, RPC 키 관리(목록 조회, 생성, 취소), 사용량 모니터링, 결제, 충전 견적 확인, 지원 티켓 생성 도구를 제공합니다.
이 툴킷이 지갑 키나 결제를 자동으로 처리하나요?
아니요, 툴킷은 지갑 키를 보유하거나 자동 결제를 수행하지 않습니다. 사용자는 계정 충전을 위해 외부 지갑 절차를 따라야 합니다.