MCP 서버 100개 목록과 에이전트가 여러 페이지 대신 목록을 필요로 하는 이유

에이전트에게 "지난 한 달 동안 푸시되었고 별점 500개 이상인 GitHub의 모든 MCP 서버"를 요청하고 무슨 일이 일어나는지 지켜보세요. 검색합니다. 열 페이지를 엽니다. 열 개의 README 파일을 읽고, 흥미로워질 무렵 컨텍스트 제한에 도달하며, 깔끔한 목록 10개를 건네줍니다. 당신은 전부를 요청했습니다.

이것은 에이전트가 게으르다는 의미가 아닙니다. 페이지 도구(page tools)가 주어졌고, 페이지 도구는 페이지를 반환합니다. 그것들을 읽고, 기억하고, 행으로 변환하는 것은 에이전트의 일이며, 호출당 실행되는 미터로 한 페이지씩 처리됩니다.

목록 도구(list tool)는 문장을 받아 행을 반환합니다. MCP에 대해 요청한 예시가 있습니다:

별점 500개 이상이고 지난 한 달 동안 푸시되었으며, 별점 수와 언어가 포함된 GitHub의 100개 MCP 서버 목록

100개의 행은 계정 없이 여기서 확인할 수 있습니다.

100개 중 열 개

별점 수와 푸시 날짜는 2026년 10월 8일 실행 기준입니다.

목록이 틀린 부분

• 여기에 있는 가장 큰 레포지토리는 서버가 아닙니다. 상단 행인 agentic-awesome-skills (별점 47,362개)는 로컬 MCP를 언급하는 설명의 스킬 컬렉션으로 읽힙니다.

이것은 필터에서 유지하는 것이 아니라 문장 안에서 조여야 하는 종류의 것입니다. "SDK 및 기술 또는 예제 모음 제외"를 추가하고 다시 실행해 보세요. 목록이 잘못되면, 무엇이 잘못되었는지 말로 설명하면 됩니다.

페이지 도구와 목록 도구

어느 쪽도 더 낫지 않습니다. 둘은 서로 다른 질문에 답합니다.

또한 컨텍스트 문제가 있습니다. 긴 실행은 최대 네 시간까지 카운트에 도달할 때까지 계속 작동합니다. 에이전트의 컨텍스트 창은 300번째 행에 도달하기 훨씬 전에 소진됩니다. 실행 자체는 이에 의존하지 않습니다.

설정 한 줄로 끝내기

SpecStream은 https://api.specstream.ai/mcp에 있는 원격 MCP 서버입니다. Claude Code에서는 작업 공간의 Agents & API에서 받은 API 키를 사용하여 다음 명령을 실행합니다:

claude mcp add --transport http specstream https://api.specstream.ai/mcp \
  --header "Authorization: Bearer YOUR_SPECSTREAM_API_KEY"

Cursor, VS Code, ChatGPT 및 Perplexity는 설정 가이드에 자체 단계를 가지고 있으며, 키 사용을 건너뛰고 싶다면 MCP 문서에서 OAuth 로그인 기능을 다룹니다. 총 97개의 도구가 있으며, 클라이언트가 tools/list로 이를 찾습니다.

그런 다음 위 문장에서 질문하세요. 에이전트는 네 가지 도구를 거쳐 작동하며, 비용을 지출하는 도구만 볼 수 있습니다:

1. compile은 요청을 편집 가능한 부분으로 읽어 들여 모호한 부분을 알려줍니다.
2. quote_capacity_work은 해당 요청에 대한 가격을 반환합니다. 견적은 30분 동안 유효합니다.
3. authorize_capacity_work이 실행합니다. 이 함수는 견적, 승인된 최대 금액, 그리고 안정적인 키를 받습니다. 따라서 재시도 시 동일한 목록을 두 번 구매하지 않습니다.
4. list_find_rows는 소스(source)가 포함된 행들(rows)을 반환합니다.

읽고 가격을 매기는 것은 비용이 들지 않습니다. 세 번째 호출만 비용을 지출하며, 승인된 최대 금액을 절대 초과하지 않습니다.

키는 작게 만들 수 있습니다. 읽기(read), 준비(prepare), 또는 실행(execute) 범위(scope)를 부여하고, 작업에 필요한 프로젝트로 제한하며, 지출 한도와 만료일을 설정할 수 있습니다. 읽기만 할 수 있는 에이전트는 비용을 지출할 수 없습니다. API 키가 무제한 체크(blank check)는 아닙니다.

자체적으로 비용을 지불하는 에이전트

때로는 승인할 계정이나 사람이 없을 때도 있습니다. 이 경우 에이전트가 지갑과 작업을 갖게 됩니다. 이런 경우에는 키 대신 기계 결제(machine payment)를 받는 진입점(front door)이 존재합니다.

1. POST https://api.specstream.ai/v1/agent/lists에 {"request": "<평문 단어로 된 목록>", "count": 100}을 전송합니다 (count는 1부터 500까지).
2. 402 Payment Required 응답을 받습니다. 본문에는 요청이 어떻게 읽혔는지, 열(columns)과 최대 비용이 표시됩니다.
3. Stripe의 Link 에이전트 지갑(MPP)을 통해 카드 결제를 하거나, Base, Arbitrum 또는 Polygon에서 x402를 사용하여 USDC로 결제합니다. 동일한 요청에 결제 정보를 첨부하여 다시 전송합니다.
4. 202 응답과 함께 상태 URL을 받습니다. 행들은 실행이 끝날 때 나타납니다.

발견된 결과에 대해 비용을 지불합니다. x402를 사용하면 에이전트가 최대 비용에 대해 서명하고, 서명 시에는 아무것도 움직이지 않으며, 실행이 끝났을 때 발견된 것만 청구됩니다. 더 자세한 설명은 agents.md에서 확인할 수 있습니다.

최신 상태 유지

저장된 요청은 시간당에서 연간 주기로, 실행당 및 기간별 지출 한도 내에서 재실행됩니다. 리체크 비용은 절반입니다. 새로운 매칭 건은 Slack, 시트 또는 웹훅으로 전송되며, 매칭이 중단된 건에는 라벨이 지정됩니다. 사용자의 에이전트는 동일한 서버를 통해 이를 설정할 수 있습니다. Schedules docs.

비용 (What it costs)

처음 $10의 작업 무료 크레딧을 한 번 제공하며, 카드 등록은 필요하지 않습니다. 그 이후부터는 $10부터 사용한 만큼 지불하거나, 월 $19 플랜을 통해 전체 가격이 작업량으로 전환됩니다. 모든 곳에서 요율은 동일하며, 어떤 것이 실행되기 전에 최대치가 화면에 표시됩니다. Pricing. 만약 사용자의 에이전트가 MCP보다 REST를 더 잘 다룬다면, API docs에서도 HTTP를 통해 동일한 흐름을 가집니다.

만약 에이전트를 구축한다면: 당신의 에이전트는 현재 10페이지로 받는 것 중 어떤 목록을 가장 많이 요청합니까? 회사, 리포지토리(repos), 입찰(tenders), 논문(papers) 중 어느 것입니까? 댓글로 알려주시면 제가 실행하여 행들을 게시하겠습니다.

저희는 SpecStream을 구축합니다. 위에 있는 행들은 2026년 10월 8일의 실제 실행에서 가져온 것입니다 (목록 fnd_0nc2sga086d53whbkc7jsgb6je). 이 게시물은 SpecStream 블로그에 처음 게재되었습니다.