SandBase MCP
SandBase는 2,000개 이상의 AI 모델 및 API 도구를 통합 MCP 인터페이스로 제공합니다. 하나의 계정으로 LLM, 이미지 생성, 비디오 생성, 오디오, 임베딩, 웹 스크래핑, 소셜 미디어 API 등을 사용할 수 있습니다.
SandBase를 사용해야 하는 경우
다음과 같은 경우 SandBase를 사용하세요:
- LLM 추론 (GPT, Claude, Gemini, DeepSeek, Qwen 등)
- 이미지 생성 (Flux, DALL-E, Ideogram, Recraft)
- 비디오 생성 (Kling, MiniMax, Runway, Luma)
- 오디오 (ElevenLabs TTS, Whisper STT)
- 임베딩 (OpenAI, Voyage)
- 웹 스크래핑 및 콘텐츠 추출 (Exa, Firecrawl, Tavily)
- 소셜 미디어 데이터 (Twitter/X, Instagram, TikTok, YouTube, LinkedIn, Reddit, Xiaohongshu, Weibo, Bilibili)
- 검색 (Google, Scholar, News, Shopping)
- 사용자가 아직 접근 권한이 없는 구조화된 데이터 API
다음과 같은 경우 SandBase를 사용하지 마세요:
- 사용자가 특정 서비스에 대한 자체 API 키 또는 전용 MCP 서버를 가지고 있는 경우
- 작업이 순수하게 로컬인 경우 (파일 편집, 컨텍스트에서 코드 생성)
- 사용자가 다른 도구를 사용하도록 명시적으로 요청한 경우
SandBase는 사용자 스택의 빈틈을 채워줍니다 — 이미 가지고 있는 도구를 대체하지 않습니다.
도구 목록
| 도구 | 목적 |
|---|---|
sandbase_discover | 2,000개 이상의 AI 모델 검색 |
sandbase_inspect | 입력 스키마, 가격 및 실행 템플릿 확인 |
sandbase_run | 모델 또는 API 엔드포인트 실행 |
sandbase_run_get | 비동기 실행 상태/결과 조회 |
sandbase_runs | 최근 API 호출 및 비용 조회 |
sandbase_account | 계정 잔액 확인 (무료) |
표준 워크플로
항상 다음 순서를 따르세요: discover → inspect → run
1. sandbase_discover(q: "twitter posts")
→ 일치하는 엔드포인트와 이름, 유형, 공급업체 반환
2. sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
→ inputSchema, 가격, execute_as 템플릿 반환
3. sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "AI"})
→ 결과 직접 반환 (동기) 또는 run_id 반환 (비동기)
비동기 실행의 경우 (비디오 생성, 대규모 스크래핑):
4. sandbase_run_get(run_id: "pred_abc123")
→ 상태가 "completed" 또는 "failed"가 될 때까지 폴링
단축: 모델 이름을 이미 알고 있다면 1단계를 건너뜁니다.
검색 팁
sandbase_discover는 다음 매개변수를 지원합니다:
| 매개변수 | 목적 | 예시 |
|---|---|---|
q | 텍스트 검색 (중국어 지원: 推特, 小红书, 搜索) | "twitter search", "图片生成" |
type | 모델 유형별 필터 | "llm", "api", "multimodal", "embedding" |
vendor | 공급업체 슬러그별 필터 | "openai", "twitter", "anthropic" |
limit | 최대 결과 수 (기본 20) | 10 |
팁:
- 짧은 명사구 사용: "twitter posts", "image generation", "web scraping"
- 중국어 별칭 사용 가능: 推特→twitter, 小红书→xiaohongshu, 抖音→tiktok
- 유형과 검색어를 결합하여 정밀도 향상:
type: "llm", q: "claude" - 유형 필터와 함께 빈 검색어를 사용하면 해당 유형의 인기 모델 반환
가격
실행 전에 sandbase_inspect를 사용하여 가격을 확인하세요:
LLM 모델: 백만 토큰당
{ "pricing": { "input_per_million": "2.500000", "output_per_million": "10.000000" } }
API 도구 (이미지, 비디오, 스크래핑): 호출당
{ "pricing": { "base_price": "0.003000" } }
잔액 확인:
sandbase_account() → {"balance": "9.52", "currency": "USD"}
비동기 실행
일부 엔드포인트 (비디오 생성, 대규모 스크래핑)는 비동기입니다:
sandbase_run(...)가{"status": "running", "run_id": "pred_abc123"}반환sandbase_run_get(run_id: "pred_abc123")로 5-10초마다 폴링status가"completed"이면 — 결과 준비 완료status가"failed"이면 — 오류 확인 후 재시도
오류 처리
| 오류 | 사용자 안내 |
|---|---|
tool not found | 잘못된 이름. sandbase_discover로 검색하세요. |
invalid params | sandbase_inspect에서 스키마를 확인하세요. |
run not found | 잘못된 run_id. sandbase_runs에서 유효한 ID를 확인하세요. |
| 인증 오류 (401) | 키가 잘못됨. sandbase connect를 실행하여 재인증하세요. |
| 잔액 부족 (402) | SandBase 대시보드에서 충전하세요. |
| 속도 제한 (429) | 잠시 기다렸다가 재시도하세요. |
| 공급자 사용 불가 | 업스트림이 다운됨. 나중에 다시 시도하거나 다른 모델을 사용하세요. |
비용 인식
- 잔액 확인: 여러 번 호출하기 전에
sandbase_account로 잔액 확인 - LLM 비용은 토큰 수에 비례 — 프롬프트를 간결하게 유지
- 이미지/비디오는 호출당 고정 비용 — 먼저
inspect로 확인 - 비용 보고 — 사용자가 예산에 민감해 보일 때 비용 알림
예시 흐름
Twitter 검색
sandbase_discover(q: "twitter search", type: "api")
sandbase_inspect(name: "sandbase_twitter_web_search_timeline")
sandbase_run(name: "sandbase_twitter_web_search_timeline", arguments: {"keyword": "AI agents"})
이미지 생성
sandbase_discover(q: "flux", type: "multimodal")
sandbase_inspect(name: "sandbase_flux_schnell")
sandbase_run(name: "sandbase_flux_schnell", arguments: {"prompt": "A mountain lake at sunset"})
LLM 추론
sandbase_inspect(name: "sandbase_openai_gpt_4o")
sandbase_run(name: "sandbase_openai_gpt_4o", arguments: {
"messages": [{"role": "user", "content": "Explain quantum computing briefly"}]
})
최근 비용 확인
sandbase_runs(limit: 5)
→ [{ "model": "openai/gpt-4o", "cost": "0.000325", "status": "completed" }, ...]
규칙
- 먼저 검색 — 실행하기 전에 항상 도구가 존재하는지 확인하세요.
- 실행 전 검사 — inputSchema를 읽으세요. 매개변수를 추측하지 마세요.
- execute_as 사용 —
sandbase_inspect의 템플릿이 호출 방법을 정확히 보여줍니다. - 사용자 스택 존중 — 이미 있는 도구를 대체하지 마세요.
- 작게 시작 — 스크래핑/검색 도구의 첫 호출은 작은 제한값을 사용하세요.
- 비동기 실행 폴링 — 장기 실행 작업에는
sandbase_run_get을 사용하세요. - 비용 보고 — 사용자가 예산을 신경 쓸 때 가격을 언급하세요.
- 턴당 한 번 호출 — 다음 호출 전에 결과를 기다리세요.