Enhance customer experiences with Apollo GraphOS

Every Token Counts: Building Efficient AI Agents with GraphQL and Apollo MCP Server


<p>After Apollo recently released the Apollo MCP Server that allows you to generate tools for any GraphQL API, I have been investigating MCP server development within Python and Typescript frameworks. It&#8217;s easy enough to build a simple tool, but I found myself feeling déjà vu as if I were building applications before GraphQL was released. Each tool I wrote started to get more complex and I quickly started seeing multiple API fetches happen in the same tool.</p>



<p>For this blog post, we&#8217;re going to look more deeply at The Space Devs APIs and the community launch library MCP server that is built in Python with the Launch Library REST API. Then we&#8217;ll look at how GraphQL can simplify the development process and provide better tools for LLM interaction.</p>



<h2 class="wp-block-heading" id="Building-simple-tools:-A-tool-for-every-REST-API-endpoint"><a href="#building-simple-tools-a-tool-for-every-rest-api-endpoint" aria-hidden="true" class="aal_anchor" id="building-simple-tools-a-tool-for-every-rest-api-endpoint"><svg aria-hidden="true" class="aal_svg" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Building simple tools: A tool for every REST API endpoint</h2>



<p>One pattern I tried developing with is making a simple tool for every Entity defined in my endpoints. This would cover returning a list of those entities in a &#8220;simplified&#8221; format that returns a subset of fields along with a detailed entity tool that returns all the fields for the entity. This is a commonly recommended pattern and here is an example of that from the launch library MCP server:</p>



<pre class="wp-block-prismatic-blocks"><code class="language-python">@mcp_llv2.tool() async def launches_list(...) 
@mcp_llv2.tool() async def launches_detailed(...)</code></pre>



<p>Overall this pattern works, but using REST means that each tool is additional code that has to be written and deployed to the MCP server. Even if you have an auto-generated REST API client, there still can be a lot of hand written code. For example, the launches_list tool contains code that is primarily related to transforming the shape of the data:</p>



<pre class="wp-block-prismatic-blocks"><code class="language-python">items = []
for x in result.results:
    items.append(
        {
            &quot;id&quot;: x.id,
            &quot;net&quot;: f&quot;{x.net} presision: {x.net_precision.name}&quot;,
            &quot;name&quot;: x.name,
            &quot;slug&quot;: x.slug,
            &quot;status&quot;: x.status.abbrev,
            &quot;rocket&quot;: x.rocket.configuration.full_name,
            &quot;orbit&quot;: x.mission.orbit.abbrev,
            &quot;provider&quot;: x.launch_service_provider.name,
            &quot;location&quot;: x.pad.location.name,
            &quot;launch_designator&quot;: x.launch_designator,
            &quot;window&quot;: (
                f&quot;{x.window_start} -{x.window_end}&quot;
                if x.window_start and x.window_end
                else None
            ),
        }
    )
return yaml.dump(
    {
        &quot;count&quot;: result.count,
        &quot;next&quot;: result.next,
        &quot;previous&quot;: result.previous,
        &quot;launches&quot;: items,
    },
    allow_unicode=True,
    sort_keys=False,
)</code></pre>



<p>Each new API endpoint brings in one or two additional tools and the pattern starts to have the LLM act as an API query planner based on these tools. There are two things to be cautious about with general REST API responses:</p>



<ol start="1" class="wp-block-list">
<li><strong>Context window bloat</strong> &#8211; as the LLM uses more tools and orchestrates the responses, additional fields that aren&#8217;t relevant to the initial question can begin to add unnecessary noise to the context window.</li>



<li><strong>API Orchestration Distractions for LLMs</strong> &#8211; each tool should encapsulate everything you need to give the proper context to the LLM for that piece of functionality. Having an LLM run through two or more tools for a given functionality because the API is broken apart is going to create additional processing overhead that is going to potentially confuse LLMs and cost more as additional tool calls are required.</li>
</ol>



<h2 class="wp-block-heading" id="GraphQL-Operations-as-MCP-Tools"><a href="#graphql-operations-as-mcp-tools" aria-hidden="true" class="aal_anchor" id="graphql-operations-as-mcp-tools"><svg aria-hidden="true" class="aal_svg" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>GraphQL Operations as MCP Tools</h2>



<p>GraphQL initially became popular with web developers in the promise of providing an operation as the contract of data needed for a given UI functionality. Agentic experiences will also have many of the functionalities our websites have and it makes sense to map a GraphQL operation to that functionality. Defining GraphQL operations as MCP tools means:</p>



<ul class="wp-block-list">
<li>No writing tool code, just define the fields you need in the operation</li>



<li>The graph does the API orchestration, not the LLM</li>



<li>Adding or updating tools can be done without code deployments</li>
</ul>



<p>To demonstrate a comparison, we created a GraphQL API for the Launch Library to create MCP tools with. In the Apollo MCP Server repository is an example operation that can be used to create an MCP tool for searching upcoming launches. GraphQL provides nice documentation capabilities that we can use to make tool descriptions. We default to comments and return type information defined in your schema but you can simply override that description by adding a comment to the top of your operation.</p>



<figure class="wp-block-image size-large"><img loading="lazy" decoding="async" width="1024" height="563" src="https://wp.apollographql.com/wp-content/uploads/2025/05/comparison-1024x563.png" alt="" class="wp-image-24348" srcset="https://wp.apollographql.com/wp-content/uploads/2025/05/comparison-1024x563.png 1024w, https://wp.apollographql.com/wp-content/uploads/2025/05/comparison-300x165.png 300w, https://wp.apollographql.com/wp-content/uploads/2025/05/comparison-768x422.png 768w, https://wp.apollographql.com/wp-content/uploads/2025/05/comparison-1536x845.png 1536w, https://wp.apollographql.com/wp-content/uploads/2025/05/comparison-1200x660.png 1200w, https://wp.apollographql.com/wp-content/uploads/2025/05/comparison.png 1920w" sizes="auto, (max-width: 1024px) 100vw, 1024px" /></figure>



<p>A nice benefit about this is how the LLM can use guided context to help re-execute the tools we defined. For example, we provide some information around the search term being best as codes or single words. The LLM understands this tool is best for short searches and can re-run them.</p>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="1000" height="1000" src="https://wp.apollographql.com/wp-content/uploads/2025/05/spacedevs.gif" alt="" class="wp-image-24350"/></figure>



<h2 class="wp-block-heading" id="Improved-developer-experience"><a href="#improved-developer-experience" aria-hidden="true" class="aal_anchor" id="improved-developer-experience"><svg aria-hidden="true" class="aal_svg" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Improved developer experience</h2>



<p>Along with having no code for your MCP tools, writing those MCP tools is simple. GraphQL endpoints have options like <a href="https://thespacedevs-production.up.railway.app/">Apollo Explorer</a> that give you a sandbox to author and test out operations that you could then run as tools. If you open the <code>/graphql/TheSpaceDevs</code> folder up in VS Code, you’ll see how you can have completion options for fields available in your schema as you write the operations:</p>



<figure class="wp-block-image size-large"><img loading="lazy" decoding="async" width="1024" height="678" src="https://wp.apollographql.com/wp-content/uploads/2025/05/Screenshot-2025-05-18-at-11.16.21 PM-1024x678.png" alt="" class="wp-image-24352" srcset="https://wp.apollographql.com/wp-content/uploads/2025/05/Screenshot-2025-05-18-at-11.16.21 PM-1024x678.png 1024w, https://wp.apollographql.com/wp-content/uploads/2025/05/Screenshot-2025-05-18-at-11.16.21 PM-300x198.png 300w, https://wp.apollographql.com/wp-content/uploads/2025/05/Screenshot-2025-05-18-at-11.16.21 PM-768x508.png 768w, https://wp.apollographql.com/wp-content/uploads/2025/05/Screenshot-2025-05-18-at-11.16.21 PM.png 1194w" sizes="auto, (max-width: 1024px) 100vw, 1024px" /></figure>



<h2 class="wp-block-heading" id="MCP-Tool-Generative-Capabilities"><a href="#mcp-tool-generative-capabilities" aria-hidden="true" class="aal_anchor" id="mcp-tool-generative-capabilities"><svg aria-hidden="true" class="aal_svg" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>MCP Tool Generative Capabilities</h2>



<p>You might also want to just have the LLM be a little more curious and learn about the schema to generate operations for tools or even to just dynamically execute. The <code>--introspection</code> option allows the LLM to enter the schema at any node and navigate the tree to keep the context window concise to the task at hand.</p>



<p>Here&#8217;s an example of the tool in action with Claude:</p>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="1920" height="1080" src="https://wp.apollographql.com/wp-content/uploads/2025/05/output.gif" alt="" class="wp-image-24354"/></figure>



<h2 class="wp-block-heading" id="Conclusion"><a href="#conclusion" aria-hidden="true" class="aal_anchor" id="conclusion"><svg aria-hidden="true" class="aal_svg" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Conclusion</h2>



<p>When you need to write MCP tools for your APIs, GraphQL gives you a serious advantage in rapid iteration. A series of tools can be created in minutes and getting started is just a single command. You can <a href="https://www.apollographql.com/docs/apollo-mcp-server/quickstart">get started today</a> with any GraphQL API, no API key or account required.</p>



<p><a href="https://www.apollographql.com/events/get-started-with-mcp-tools-for-your-graphql-api-today">Check out</a> my latest Apollo livestream from 5/21/2025 where I dive into developer workflows like hot-reloading with your MCP server with some Q&amp;A at the end for MCP questions.</p>



<p></p>


Apollo MCP Server

Every Token Counts: Building Efficient AI Agents with GraphQL and Apollo MCP Server

Building MCP Tools with GraphQL: A Better Way to Connect LLMs to Your API

Stay in our orbit