"The reality is that documentation is no longer just a piece of context or data found when an external developer runs into an issue — it’s a first-class context object that needs to be treated with the same focus and intentionality as the API itself. Within this context, MCP offers something more than just putting all the documentation in a single store and hoping for the best — it provides a direct pathway between the developer and the provider, allowing you to discover intent, and clarity like no other process currently on offer.

As we move towards a future focused around API discovery, we need to rethink how we look at documentation and its discovery — and solutions like MCP are going to play a huge part in making documentation and data clearer, more contextual, and more available."

https://nordicapis.com/using-mcp-for-api-documentation-discovery/

#AI #GenerativeAI #AIAgents #AgenticAI #MCP #MCPServers #Documentation #APIDocumentation #SoftwareDocumentation #DeveloperDocumentation #APIs #APIDiscovery

Using MCP For API Documentation Discovery | Nordic APIs |

How Model Context Protocol enables deterministic, agent-driven API documentation discovery beyond search and RAG.

Nordic APIs

"Formalizing AI workflows into reusable commands makes them more reliable and consistent than having to write a prompt every time we need help with something. When I run this command, it follows the same research steps in the same order, which means it's easier to find everything relevant and not forget about something.

The two-phase approach — research first, writing second — I think is also worth the extra step. Someone might want to just research a ticket and not write a draft. Also, this way the command works for other colleagues in the team who aren't tech writers.

MCP integrations are what make this a powerful tool. The ability to pull data from multiple internal tools in a single session is the foundation everything else is built on.

And as always: AI doesn't replace the tech writer's judgment. It replaces the tedious context-gathering so we can spend more time on the parts of the job that actually require expertise — deciding what customers need to know and how best to explain it.

If you want to try building something similar, OpenCode supports custom commands and agent skills. The setup takes a few minutes: define a command file with your research steps, create skill files with your docs framework conventions, and you have a reusable workflow. The OpenCode docs cover how to create commands and agent skills."

https://www.linkedin.com/pulse/building-ai-research-command-documentation-tickets-m%C3%A1rcio-florindo-mc4te/

#TechnicalWriting #OpenCode #Jira #JiraTickets #AI #GenerativeAI #AIWorkflows #ReusableCommands #MCP #MCPServers

Building an AI research command for documentation tickets

Tech writers spend a lot of time researching before they can start writing. Gathering context for a single ticket might mean jumping between several Jira tickets, existing documentation, internal wiki pages with PRDs or technical specs… Some tickets might have whole discussions with back and forths

"BP: Yeah. So, so behind the scenes, many people ask me also this, “What is actually going on behind the scenes on MCP?” Isn’t it just an API, in the end?

EP: I think at a high level, it is an API. And, it’s another iteration of APIs. So, just because it has more native capabilities for AI. I mean, that’s great, but it is by all definitions an API. And we need that API.

BP: Yeah, I mentioned it because people who prefer to use OpenAPI initially thought that MCP would go against OpenAPI or would be used instead of OpenAPI.

EP: I use MCP with OpenAPI all the time. And I find that if you have really good OpenAPI, which probably means also you have really well-structured APIs. I find it means that you can produce a really good MCP server that has a good task success rate for the LLM. So, hand in hand."

https://apichangelog.substack.com/p/mcp-is-just-an-api

#AI #GenerativeAI #LLMs #APIs #MCP #MCPServers #CyberSecurity #PromptInjection

MCP Is Just an API

Can API PMs manage MCPs? It’s the next logical step.

The API Changelog

Ragex: Гибридный RAG для анализа кода

Я поломался, поломался — и поломался на осколки. Признаю́: железные помощники Т9 действительно могут приносить пользу в разработке. Единственное, что мне не нравилось — то, что весь проект большой и хорошо натренированной модели не скормишь, а значит — неизбежны потери контекста, размывание смыслов и джойсовские галлюцинации. Я уже давно понял: если мне нужно, чтобы что-то было сделано хорошо, — делегирование отпадает, придётся брать в руки молоток самому. Это касается любых жизненных аспектов: варки борща, замены сантехники, перевода Эдгара Аллана По или Антонио Мачадо на русский, или, там, программирования. Когда БЯМ научились подключать сторонние MCP-сервера, произошел качественный скачок. Теперь не нужно файнтьюнить модель, можно файнтьюнить буковку « R » из акронима « R AG ». Я-то лучше знаю, как правильно извлекать смыслы из моего личного контента. Если речь про код — лучше всего искать правду в AST . Так и был зачат Ragex — MCP-сервер для семантического анализа кодовых баз с элементами чёрной магии. Проект, понятно, написан на Elixir , потому что ну а на чем еще?

https://habr.com/ru/articles/982418/

#mcpserver #mcptools #mcpservers #mcpсервер #mcp_server #rag #rag_pipeline #rag_ai

Ragex: Гибридный RAG для анализа кода

Я поломался, поломался — и поломался на осколки. Признаю́: железные помощники Т9 действительно могут приносить пользу в разработке. Единственное, что мне не нравилось — то, что весь проект...

Хабр

"In this podcast episode, Fabrizio Ferri Benedetti and I chat with guest Anandi Knuppel about MCP servers and the role that technical writers can play in shaping AI capabilities and outcomes. Anandi shares insights on how writers can optimize documentation for LLM performance and expands on opportunities to collaborate with developers around AI tools. Our discussion also touches on ways to automate style consistency in docs, and the future directions of technical writing given the abundance of AI tools, MCP servers, and the central role that language plays in it all."

https://idratherbewriting.com/blog/mcp-tools-language-tech-writing

#TechnicalWriting #AI #GenerativeAI #MCP #MCPServers #LLMs #SoftwareDocumentation #Docs

MCP servers and the role tech writers can play in shaping AI capabilities and outcomes – podcast with Fabrizio Ferri Beneditti and Anandi Knuppel

In this podcast episode, Fabrizio Ferri Benedetti and I chat with guest Anandi Knuppel about MCP servers and the role that technical writers can play in shaping AI capabilities and outcomes. Anandi shares insights on how writers can optimize documentation for LLM performance and expands on opportunities to collaborate with developers around AI tools. Our discussion also touches on ways to automate style consistency in docs, and the future directions of technical writing given the abundance of AI tools, MCP servers, and the central role that language plays in it all.

I’d Rather Be Writing Blog and API doc course
GitHub - hyprmcp/jetski: Authentication, analytics, and prompt visibility for MCP servers with zero code changes. Supports OAuth2.1, DCR, real-time logs, and client onboarding out of the box

Authentication, analytics, and prompt visibility for MCP servers with zero code changes. Supports OAuth2.1, DCR, real-time logs, and client onboarding out of the box - hyprmcp/jetski

GitHub
📢 Breaking news, folks: a revolutionary new method to intercept prompts from MCP servers has emerged, which nobody knew they needed until now. 🙄 Philip, the engineering wizard behind this wonder, promises to unravel the secrets of prompt analytics for the three people on the waitlist who actually care. 🥳✨
https://hyprmcp.com/blog/mcp-server-prompt-analytics/ #breakingnews #promptanalytics #MCPservers #engineeringwizard #techinnovation #HackerNews #ngated
Prompt Analytics for MCP Servers

How to intercept the prompt that triggered the MCP Server tool call for MCP prompt analytics.

Hypr MCP
Prompt Analytics for MCP Servers

How to intercept the prompt that triggered the MCP Server tool call for MCP prompt analytics.

Hypr MCP

Unlock next-level productivity! Discover the power of VS Code MCP Servers & GitHub Copilot. Automate tasks, integrate tools, and supercharge your workflow inside VS Code. #VSCode #GitHubCopilot #MCPservers #productivity #coding

https://teguhteja.id/amazing-vs-code-mcp-servers/?utm_source=mastodon&utm_medium=jetpack_social

Amazing! 7 VS Code MCP Servers Will Blow Your Mind

VS Code MCP Servers revealed! Supercharge Copilot & your workflow! See how to automate tasks & code smarter. Click to learn!

teguhteja

Yet another GitHub Copilot workshop with more than 30 people done and dusted 🚀
I love to see the panic in people’s eyes when they realise how dangerous the use of MCP servers are. Especially multiple MCP Servers combined 🤯🔥

#GitHubCopilot #VSCode #Speaker #MCPServers